home *** CD-ROM | disk | FTP | other *** search
| MacBinary | 1994-07-24 | 1.4 MB | [ONLN/HLX2] |
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: MacBinary
(archive/macBinary).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 10%
| dexvert
| MacBinary (archive/macBinary)
| fallback
| Supported |
| 100%
| file
| MacBinary II, inited, Thu Jul 15 15:06:27 1993, modified Sun Jul 24 14:51:16 1994, creator 'HLX2', type 'ONLN', 1449569 bytes "TN-Devices" , at 0x161ee1 39331 bytes resource
| default (weak)
| |
| 99%
| file
| data
| default
| |
| 100%
| TrID
| MacBinary 2
| default (weak)
| |
| 100%
| siegfried
| fmt/1762 MacBinary (II)
| default
| |
| 100%
| lsar
| MacBinary
| default
|
|
| id metadata |
|---|
| key | value |
|---|
| macFileType | [ONLN] |
| macFileCreator | [HLX2] |
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 0a 54 4e 2d 44 65 76 | 69 63 65 73 00 00 00 00 |..TN-Dev|ices....|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 16 1e 61 00 | 00 99 a3 a8 6b 5b 33 aa |......a.|....k[3.|
|00000060| 58 68 a4 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |Xh......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 5d 39 00 00 |........|....]9..|
|00000080| 44 56 20 31 20 2d 20 41 | 62 73 6f 6c 75 74 65 20 |DV 1 - A|bsolute |
|00000090| 50 6f 69 6e 74 69 6e 67 | 20 44 65 76 69 63 65 20 |Pointing| Device |
|000000a0| 4d 65 6d 6f 72 79 20 53 | 74 72 75 63 74 75 72 65 |Memory S|tructure|
|000000b0| 0d 44 65 76 69 63 65 73 | 09 0d 52 65 76 69 73 65 |.Devices|..Revise|
|000000c0| 64 20 62 79 3a 20 44 61 | 76 65 20 46 6c 65 63 6b |d by: Da|ve Fleck|
|000000d0| 2c 20 44 6f 6e 20 4b 6f | 20 26 20 52 69 63 68 61 |, Don Ko| & Richa|
|000000e0| 72 64 20 42 72 65 65 6e | 09 41 70 72 69 6c 20 31 |rd Breen|.April 1|
|000000f0| 39 39 32 0d 57 72 69 74 | 74 65 6e 20 62 79 3a 20 |992.Writ|ten by: |
|00000100| 20 44 61 76 69 64 20 53 | 74 65 76 65 6e 73 6f 6e | David S|tevenson|
|00000110| 09 46 65 62 72 75 61 72 | 79 20 31 39 39 30 0d 54 |.Februar|y 1990.T|
|00000120| 68 69 73 20 54 65 63 68 | 6e 69 63 61 6c 20 4e 6f |his Tech|nical No|
|00000130| 74 65 20 73 70 65 63 69 | 66 69 65 73 20 61 20 6d |te speci|fies a m|
|00000140| 65 6d 6f 72 79 20 64 61 | 74 61 20 73 74 72 75 63 |emory da|ta struc|
|00000150| 74 75 72 65 20 66 6f 72 | 20 75 73 65 20 62 79 20 |ture for| use by |
|00000160| 61 62 73 6f 6c 75 74 65 | 20 70 6f 69 6e 74 69 6e |absolute| pointin|
|00000170| 67 20 64 65 76 69 63 65 | 73 3b 20 69 74 20 77 61 |g device|s; it wa|
|00000180| 73 20 64 65 76 65 6c 6f | 70 65 64 20 66 6f 72 20 |s develo|ped for |
|00000190| 74 68 65 20 41 70 70 6c | 65 20 44 65 73 6b 74 6f |the Appl|e Deskto|
|000001a0| 70 20 42 75 73 20 28 41 | 44 42 29 20 62 75 74 20 |p Bus (A|DB) but |
|000001b0| 63 6f 75 6c 64 20 61 6c | 73 6f 20 62 65 20 75 73 |could al|so be us|
|000001c0| 65 64 20 66 6f 72 20 64 | 65 76 69 63 65 73 20 75 |ed for d|evices u|
|000001d0| 73 69 6e 67 20 73 65 72 | 69 61 6c 20 69 6e 70 75 |sing ser|ial inpu|
|000001e0| 74 2e 20 47 65 6e 65 72 | 61 6c 6c 79 2c 20 74 68 |t. Gener|ally, th|
|000001f0| 69 73 20 64 61 74 61 20 | 73 74 72 75 63 74 75 72 |is data |structur|
|00000200| 65 20 69 73 20 63 72 65 | 61 74 65 64 20 61 6e 64 |e is cre|ated and|
|00000210| 20 75 70 64 61 74 65 64 | 20 62 79 20 74 68 65 20 | updated| by the |
|00000220| 70 6f 69 6e 74 69 6e 67 | 20 64 65 76 69 63 65 d5 |pointing| device.|
|00000230| 73 20 64 72 69 76 65 72 | 20 61 6e 64 20 72 65 61 |s driver| and rea|
|00000240| 64 20 62 79 20 65 69 74 | 68 65 72 20 61 6e 20 61 |d by eit|her an a|
|00000250| 70 70 6c 69 63 61 74 69 | 6f 6e 20 6f 72 20 74 68 |pplicati|on or th|
|00000260| 65 20 73 79 73 74 65 6d | 20 63 75 72 73 6f 72 20 |e system| cursor |
|00000270| 72 65 6e 64 65 72 69 6e | 67 20 73 6f 66 74 77 61 |renderin|g softwa|
|00000280| 72 65 2e 0d 44 65 66 69 | 6e 69 74 69 6f 6e 73 0d |re..Defi|nitions.|
|00000290| 54 68 65 20 64 61 74 61 | 20 73 74 72 75 63 74 75 |The data| structu|
|000002a0| 72 65 20 73 68 6f 75 6c | 64 20 72 65 73 69 64 65 |re shoul|d reside|
|000002b0| 20 69 6e 20 6d 65 6d 6f | 72 79 20 61 6c 6c 6f 63 | in memo|ry alloc|
|000002c0| 61 74 65 64 20 62 79 20 | 74 68 65 20 64 72 69 76 |ated by |the driv|
|000002d0| 65 72 20 61 74 20 69 6e | 73 74 61 6c 6c 61 74 69 |er at in|stallati|
|000002e0| 6f 6e 20 74 69 6d 65 2e | 0d 41 6e 20 61 70 70 6c |on time.|.An appl|
|000002f0| 69 63 61 74 69 6f 6e 20 | 73 68 6f 75 6c 64 20 61 |ication |should a|
|00000300| 74 74 65 6d 70 74 20 74 | 6f 20 61 63 63 65 73 73 |ttempt t|o access|
|00000310| 20 74 68 65 20 64 61 74 | 61 20 73 74 72 75 63 74 | the dat|a struct|
|00000320| 75 72 65 20 76 69 61 20 | 61 6e 20 4f 70 65 6e 44 |ure via |an OpenD|
|00000330| 72 69 76 65 72 20 63 61 | 6c 6c 2c 20 70 61 73 73 |river ca|ll, pass|
|00000340| 69 6e 67 20 61 20 6e 61 | 6d 65 20 6f 66 20 d2 2e |ing a na|me of ..|
|00000350| 41 50 44 d3 20 28 41 62 | 73 6f 6c 75 74 65 20 50 |APD. (Ab|solute P|
|00000360| 6f 69 6e 74 69 6e 67 20 | 44 65 76 69 63 65 29 2e |ointing |Device).|
|00000370| 20 49 66 20 74 68 65 20 | 63 61 6c 6c 20 69 73 20 | If the |call is |
|00000380| 73 75 63 63 65 73 73 66 | 75 6c 2c 20 61 20 53 74 |successf|ul, a St|
|00000390| 61 74 75 73 20 63 61 6c | 6c 20 73 68 6f 75 6c 64 |atus cal|l should|
|000003a0| 20 74 68 65 6e 20 62 65 | 20 69 73 73 75 65 64 2c | then be| issued,|
|000003b0| 20 70 61 73 73 69 6e 67 | 20 61 20 63 6f 64 65 20 | passing| a code |
|000003c0| 6f 66 20 32 30 20 61 6e | 64 20 61 20 70 6f 69 6e |of 20 an|d a poin|
|000003d0| 74 65 72 20 74 6f 20 61 | 20 6c 6f 6e 67 77 6f 72 |ter to a| longwor|
|000003e0| 64 20 77 68 65 72 65 20 | 74 68 65 20 61 64 64 72 |d where |the addr|
|000003f0| 65 73 73 20 6f 66 20 74 | 68 65 20 64 61 74 61 20 |ess of t|he data |
|00000400| 73 74 72 75 63 74 75 72 | 65 20 77 69 6c 6c 20 62 |structur|e will b|
|00000410| 65 20 72 65 74 75 72 6e | 65 64 2e 0d 49 66 20 74 |e return|ed..If t|
|00000420| 68 65 20 4f 70 65 6e 44 | 72 69 76 65 72 20 63 61 |he OpenD|river ca|
|00000430| 6c 6c 20 66 61 69 6c 73 | 2c 20 61 20 47 65 74 41 |ll fails|, a GetA|
|00000440| 44 42 49 6e 66 6f 20 63 | 61 6c 6c 20 73 68 6f 75 |DBInfo c|all shou|
|00000450| 6c 64 20 62 65 20 69 73 | 73 75 65 64 20 61 73 20 |ld be is|sued as |
|00000460| 64 65 73 63 72 69 62 65 | 64 20 62 65 6c 6f 77 2e |describe|d below.|
|00000470| 0d 46 6f 72 20 61 6e 20 | 41 44 42 20 70 6f 69 6e |.For an |ADB poin|
|00000480| 74 69 6e 67 20 64 65 76 | 69 63 65 20 64 72 69 76 |ting dev|ice driv|
|00000490| 65 72 2c 20 74 68 69 73 | 20 73 74 72 75 63 74 75 |er, this| structu|
|000004a0| 72 65 20 73 68 6f 75 6c | 64 20 62 65 20 70 6f 69 |re shoul|d be poi|
|000004b0| 6e 74 65 64 20 74 6f 20 | 62 79 20 74 68 65 20 d2 |nted to |by the .|
|000004c0| 6f 70 74 69 6f 6e 61 6c | 20 64 61 74 61 20 61 72 |optional| data ar|
|000004d0| 65 61 d3 20 50 6f 69 6e | 74 65 72 20 77 68 69 63 |ea. Poin|ter whic|
|000004e0| 68 20 69 73 20 70 61 73 | 73 65 64 20 74 6f 20 5f |h is pas|sed to _|
|000004f0| 53 65 74 41 44 42 49 6e | 66 6f 2e 20 53 79 73 74 |SetADBIn|fo. Syst|
|00000500| 65 6d 20 73 6f 66 74 77 | 61 72 65 20 61 6e 64 20 |em softw|are and |
|00000510| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 73 6f 66 74 |applicat|ion soft|
|00000520| 77 61 72 65 20 63 61 6e | 20 74 68 65 6e 20 66 69 |ware can| then fi|
|00000530| 6e 64 20 74 68 69 73 20 | 64 61 74 61 20 73 74 72 |nd this |data str|
|00000540| 75 63 74 75 72 65 20 62 | 79 20 63 61 6c 6c 69 6e |ucture b|y callin|
|00000550| 67 20 5f 47 65 74 41 44 | 42 49 6e 66 6f 20 77 69 |g _GetAD|BInfo wi|
|00000560| 74 68 20 61 6e 20 41 44 | 42 20 64 65 76 69 63 65 |th an AD|B device|
|00000570| 20 61 64 64 72 65 73 73 | 20 6f 66 20 34 20 61 6e | address| of 4 an|
|00000580| 64 20 64 65 72 65 66 65 | 72 65 6e 63 69 6e 67 20 |d derefe|rencing |
|00000590| 74 68 65 20 64 61 74 61 | 20 61 72 65 61 20 70 6f |the data| area po|
|000005a0| 69 6e 74 65 72 2e 0d 50 | 6f 69 6e 74 69 6e 67 20 |inter..P|ointing |
|000005b0| 64 65 76 69 63 65 73 20 | 61 6e 64 20 64 72 69 76 |devices |and driv|
|000005c0| 65 72 73 20 74 68 61 74 | 20 73 75 70 70 6f 72 74 |ers that| support|
|000005d0| 20 74 68 69 73 20 64 61 | 74 61 20 73 74 72 75 63 | this da|ta struc|
|000005e0| 74 75 72 65 20 73 68 6f | 75 6c 64 20 69 6e 64 69 |ture sho|uld indi|
|000005f0| 63 61 74 65 20 74 68 61 | 74 20 74 68 65 79 20 64 |cate tha|t they d|
|00000600| 6f 20 73 6f 20 62 79 20 | 70 72 6f 76 69 64 69 6e |o so by |providin|
|00000610| 67 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |g the fo|llowing |
|00000620| 69 64 65 6e 74 69 66 69 | 63 61 74 69 6f 6e 3a 20 |identifi|cation: |
|00000630| 74 68 65 20 41 53 43 49 | 49 20 63 68 61 72 61 63 |the ASCI|I charac|
|00000640| 74 65 72 73 20 27 54 42 | 4c 54 27 20 69 6e 20 74 |ters 'TB|LT' in t|
|00000650| 68 65 20 74 65 6e 74 68 | 20 6c 6f 6e 67 77 6f 72 |he tenth| longwor|
|00000660| 64 20 6f 66 20 74 68 65 | 20 68 65 61 64 65 72 20 |d of the| header |
|00000670| 61 6e 64 20 74 68 65 20 | 6e 75 6d 62 65 72 20 6f |and the |number o|
|00000680| 66 20 74 68 65 20 70 61 | 72 74 69 63 75 6c 61 72 |f the pa|rticular|
|00000690| 20 76 65 72 73 69 6f 6e | 20 6f 66 20 74 68 65 20 | version| of the |
|000006a0| 73 74 72 75 63 74 75 72 | 65 20 74 68 65 20 64 72 |structur|e the dr|
|000006b0| 69 76 65 72 20 73 75 70 | 70 6f 72 74 73 20 69 6e |iver sup|ports in|
|000006c0| 20 74 68 65 20 76 65 72 | 73 69 6f 6e 20 66 69 65 | the ver|sion fie|
|000006d0| 6c 64 20 6f 66 20 74 68 | 65 20 66 69 72 73 74 20 |ld of th|e first |
|000006e0| 6c 6f 6e 67 77 6f 72 64 | 20 6f 66 20 74 68 65 20 |longword| of the |
|000006f0| 68 65 61 64 65 72 2e 20 | 46 69 67 75 72 65 20 31 |header. |Figure 1|
|00000700| 20 73 68 6f 77 73 20 74 | 68 65 20 66 6f 72 6d 61 | shows t|he forma|
|00000710| 74 20 6f 66 20 61 20 6c | 6f 6e 67 77 6f 72 64 2e |t of a l|ongword.|
|00000720| 0d 46 69 67 75 72 65 20 | 31 20 46 6f 72 6d 61 74 |.Figure |1 Format|
|00000730| 20 6f 66 20 61 20 4c 6f | 6e 67 77 6f 72 64 20 20 | of a Lo|ngword |
|00000740| 0d 42 69 74 20 66 69 65 | 6c 64 73 20 77 69 74 68 |.Bit fie|lds with|
|00000750| 69 6e 20 61 20 6c 6f 6e | 67 77 6f 72 64 20 61 72 |in a lon|gword ar|
|00000760| 65 20 73 70 65 63 69 66 | 69 65 64 20 62 79 20 61 |e specif|ied by a|
|00000770| 2d 62 20 77 68 65 72 65 | 20 61 20 69 73 20 74 68 |-b where| a is th|
|00000780| 65 20 6c 65 66 74 6d 6f | 73 74 20 62 69 74 20 61 |e leftmo|st bit a|
|00000790| 6e 64 20 62 20 69 73 20 | 74 68 65 20 72 69 67 68 |nd b is |the righ|
|000007a0| 74 6d 6f 73 74 20 62 69 | 74 3b 20 66 6f 72 20 65 |tmost bi|t; for e|
|000007b0| 78 61 6d 70 6c 65 2c 20 | 37 d0 30 20 73 70 65 63 |xample, |7.0 spec|
|000007c0| 69 66 69 65 73 20 74 68 | 65 20 66 6f 75 72 74 68 |ifies th|e fourth|
|000007d0| 20 6c 65 61 73 74 20 73 | 69 67 6e 69 66 69 63 61 | least s|ignifica|
|000007e0| 6e 74 20 62 79 74 65 20 | 69 6e 20 74 68 65 20 6c |nt byte |in the l|
|000007f0| 6f 6e 67 77 6f 72 64 2e | 0d 54 68 65 20 64 61 74 |ongword.|.The dat|
|00000800| 61 20 73 74 72 75 63 74 | 75 72 65 20 66 6f 72 20 |a struct|ure for |
|00000810| 74 61 62 6c 65 74 73 20 | 61 6e 64 20 6f 74 68 65 |tablets |and othe|
|00000820| 72 20 61 62 73 6f 6c 75 | 74 65 20 70 6f 69 6e 74 |r absolu|te point|
|00000830| 69 6e 67 20 64 65 76 69 | 63 65 73 20 63 6f 6e 73 |ing devi|ces cons|
|00000840| 69 73 74 73 20 6f 66 20 | 61 20 34 30 2d 62 79 74 |ists of |a 40-byt|
|00000850| 65 20 68 65 61 64 65 72 | 20 70 6c 75 73 20 6f 6e |e header| plus on|
|00000860| 65 20 36 30 2d 62 79 74 | 65 20 62 6c 6f 63 6b 20 |e 60-byt|e block |
|00000870| 70 65 72 20 63 75 72 73 | 6f 72 2e 20 54 68 65 20 |per curs|or. The |
|00000880| 68 65 61 64 65 72 20 63 | 6f 6e 74 61 69 6e 73 20 |header c|ontains |
|00000890| 61 20 70 6f 69 6e 74 65 | 72 20 74 68 61 74 20 63 |a pointe|r that c|
|000008a0| 61 6e 20 62 65 20 75 73 | 65 64 20 74 6f 20 65 78 |an be us|ed to ex|
|000008b0| 74 65 6e 64 20 74 68 69 | 73 20 73 74 72 75 63 74 |tend thi|s struct|
|000008c0| 75 72 65 20 74 6f 20 63 | 6f 6e 74 61 69 6e 20 61 |ure to c|ontain a|
|000008d0| 64 64 69 74 69 6f 6e 61 | 6c 20 69 6e 66 6f 72 6d |dditiona|l inform|
|000008e0| 61 74 69 6f 6e 20 73 75 | 70 70 6c 69 65 64 20 62 |ation su|pplied b|
|000008f0| 79 20 70 61 72 74 69 63 | 75 6c 61 72 20 64 65 76 |y partic|ular dev|
|00000900| 69 63 65 73 2e 0d 48 65 | 61 64 65 72 0d 54 68 65 |ices..He|ader.The|
|00000910| 20 66 69 72 73 74 20 6c | 6f 6e 67 77 6f 72 64 20 | first l|ongword |
|00000920| 6f 66 20 74 68 65 20 68 | 65 61 64 65 72 20 63 6f |of the h|eader co|
|00000930| 6e 73 69 73 74 73 20 6f | 66 20 74 68 65 20 66 6f |nsists o|f the fo|
|00000940| 6c 6c 6f 77 69 6e 67 2c | 20 61 73 20 69 6c 6c 75 |llowing,| as illu|
|00000950| 73 74 72 61 74 65 64 20 | 69 6e 20 46 69 67 75 72 |strated |in Figur|
|00000960| 65 20 32 3a 20 64 61 74 | 61 20 73 74 72 75 63 74 |e 2: dat|a struct|
|00000970| 75 72 65 20 76 65 72 73 | 69 6f 6e 20 6e 75 6d 62 |ure vers|ion numb|
|00000980| 65 72 2c 20 73 79 6e 63 | 68 72 6f 6e 69 7a 61 74 |er, sync|hronizat|
|00000990| 69 6f 6e 20 73 65 6d 61 | 70 68 6f 72 65 2c 20 6e |ion sema|phore, n|
|000009a0| 75 6d 62 65 72 20 6f 66 | 20 63 75 72 73 6f 72 73 |umber of| cursors|
|000009b0| 2c 20 75 70 64 61 74 65 | 20 66 6c 61 67 73 2e 0d |, update| flags..|
|000009c0| 46 69 67 75 72 65 20 32 | 20 46 6f 72 6d 61 74 20 |Figure 2| Format |
|000009d0| 6f 66 20 48 65 61 64 65 | 72 d5 73 20 46 69 72 73 |of Heade|r.s Firs|
|000009e0| 74 20 4c 6f 6e 67 77 6f | 72 64 20 20 0d 41 6e 20 |t Longwo|rd .An |
|000009f0| 65 69 67 68 74 2d 62 69 | 74 20 66 69 65 6c 64 20 |eight-bi|t field |
|00000a00| 28 76 65 72 73 69 6f 6e | 2c 20 62 69 74 73 20 33 |(version|, bits 3|
|00000a10| 31 d0 32 34 29 20 69 6e | 64 69 63 61 74 65 73 20 |1.24) in|dicates |
|00000a20| 74 68 65 20 76 65 72 73 | 69 6f 6e 20 6e 75 6d 62 |the vers|ion numb|
|00000a30| 65 72 20 6f 66 20 74 68 | 65 20 64 61 74 61 20 73 |er of th|e data s|
|00000a40| 74 72 75 63 74 75 72 65 | 20 66 6f 72 6d 61 74 3a |tructure| format:|
|00000a50| 20 61 20 76 61 6c 75 65 | 20 6f 66 20 61 6c 6c 20 | a value| of all |
|00000a60| 7a 65 72 6f 73 20 6f 72 | 20 61 6c 6c 20 6f 6e 65 |zeros or| all one|
|00000a70| 73 20 69 73 20 69 6e 76 | 61 6c 69 64 20 61 6e 64 |s is inv|alid and|
|00000a80| 20 69 6e 64 69 63 61 74 | 65 73 20 61 6e 20 75 6e | indicat|es an un|
|00000a90| 69 6e 69 74 69 61 6c 69 | 7a 65 64 20 6f 72 20 70 |initiali|zed or p|
|00000aa0| 6f 73 73 69 62 6c 79 20 | 63 6f 72 72 75 70 74 65 |ossibly |corrupte|
|00000ab0| 64 20 64 61 74 61 20 73 | 74 72 75 63 74 75 72 65 |d data s|tructure|
|00000ac0| 3b 20 61 20 76 61 6c 75 | 65 20 6f 66 20 32 20 69 |; a valu|e of 2 i|
|00000ad0| 6e 64 69 63 61 74 65 73 | 20 74 68 61 74 20 74 68 |ndicates| that th|
|00000ae0| 65 20 66 6f 72 6d 61 74 | 20 69 73 20 74 68 65 20 |e format| is the |
|00000af0| 6f 6e 65 20 68 65 72 65 | 2e 20 54 68 65 20 73 65 |one here|. The se|
|00000b00| 63 6f 6e 64 20 65 69 67 | 68 74 2d 62 69 74 20 66 |cond eig|ht-bit f|
|00000b10| 69 65 6c 64 20 28 73 65 | 6d 61 70 68 6f 72 65 2c |ield (se|maphore,|
|00000b20| 20 62 69 74 73 20 32 33 | d0 31 36 29 20 69 73 20 | bits 23|.16) is |
|00000b30| 75 73 65 64 20 61 73 20 | 61 20 73 65 6d 61 70 68 |used as |a semaph|
|00000b40| 6f 72 65 20 74 6f 20 63 | 6f 6f 72 64 69 6e 61 74 |ore to c|oordinat|
|00000b50| 65 20 61 63 63 65 73 73 | 20 74 6f 20 74 68 69 73 |e access| to this|
|00000b60| 20 64 61 74 61 20 73 74 | 72 75 63 74 75 72 65 20 | data st|ructure |
|00000b70| 61 6d 6f 6e 67 20 6d 75 | 6c 74 69 70 6c 65 20 70 |among mu|ltiple p|
|00000b80| 72 6f 63 65 73 73 65 73 | 2e 20 28 54 68 65 72 65 |rocesses|. (There|
|00000b90| 20 69 73 20 63 75 72 72 | 65 6e 74 6c 79 20 6e 6f | is curr|ently no|
|00000ba0| 20 6f 70 65 72 61 74 69 | 6e 67 20 73 79 73 74 65 | operati|ng syste|
|00000bb0| 6d 20 73 75 70 70 6f 72 | 74 20 66 6f 72 20 6d 75 |m suppor|t for mu|
|00000bc0| 6c 74 69 70 6c 65 20 70 | 72 6f 63 65 73 73 65 73 |ltiple p|rocesses|
|00000bd0| 20 73 79 6e 63 68 72 6f | 6e 69 7a 69 6e 67 20 62 | synchro|nizing b|
|00000be0| 79 20 75 73 69 6e 67 20 | 61 20 73 65 6d 61 70 68 |y using |a semaph|
|00000bf0| 6f 72 65 2e 29 20 54 68 | 65 20 74 68 69 72 64 20 |ore.) Th|e third |
|00000c00| 65 69 67 68 74 2d 62 69 | 74 20 66 69 65 6c 64 20 |eight-bi|t field |
|00000c10| 28 63 75 72 73 6f 72 73 | 2c 20 62 69 74 73 20 31 |(cursors|, bits 1|
|00000c20| 35 d0 38 29 20 69 6e 64 | 69 63 61 74 65 73 20 74 |5.8) ind|icates t|
|00000c30| 68 65 20 6e 75 6d 62 65 | 72 20 6f 66 20 63 75 72 |he numbe|r of cur|
|00000c40| 73 6f 72 73 20 6f 6e 20 | 74 68 65 20 64 65 76 69 |sors on |the devi|
|00000c50| 63 65 2e 20 54 77 6f 20 | 70 61 69 72 73 20 6f 66 |ce. Two |pairs of|
|00000c60| 20 66 6c 61 67 73 20 61 | 72 65 20 75 73 65 64 20 | flags a|re used |
|00000c70| 74 6f 20 69 6e 64 69 63 | 61 74 65 20 75 70 64 61 |to indic|ate upda|
|00000c80| 74 65 64 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |ted info|rmation |
|00000c90| 28 6e 65 77 20 61 74 74 | 72 69 62 75 74 65 73 20 |(new att|ributes |
|00000ca0| 28 61 29 20 6f 72 20 6e | 65 77 20 64 61 74 61 20 |(a) or n|ew data |
|00000cb0| 28 64 29 29 3a 20 20 6f | 6e 65 20 70 61 69 72 20 |(d)): o|ne pair |
|00000cc0| 28 61 70 70 20 61 2c 20 | 62 69 74 20 37 2c 20 61 |(app a, |bit 7, a|
|00000cd0| 6e 64 20 61 70 70 20 64 | 2c 20 62 69 74 20 36 29 |nd app d|, bit 6)|
|00000ce0| 20 69 73 20 73 65 74 20 | 62 79 20 74 68 65 20 61 | is set |by the a|
|00000cf0| 70 70 6c 69 63 61 74 69 | 6f 6e 20 61 6e 64 20 72 |pplicati|on and r|
|00000d00| 65 61 64 20 61 6e 64 20 | 63 6c 65 61 72 65 64 20 |ead and |cleared |
|00000d10| 62 79 20 74 68 65 20 64 | 65 76 69 63 65 20 64 72 |by the d|evice dr|
|00000d20| 69 76 65 72 2c 20 77 68 | 69 6c 65 20 74 68 65 20 |iver, wh|ile the |
|00000d30| 6f 74 68 65 72 20 70 61 | 69 72 20 28 64 65 76 20 |other pa|ir (dev |
|00000d40| 61 2c 20 62 69 74 20 33 | 2c 20 61 6e 64 20 64 65 |a, bit 3|, and de|
|00000d50| 76 20 64 2c 20 62 69 74 | 20 32 29 20 69 73 20 73 |v d, bit| 2) is s|
|00000d60| 65 74 20 62 79 20 74 68 | 65 20 64 72 69 76 65 72 |et by th|e driver|
|00000d70| 20 61 6e 64 20 72 65 61 | 64 20 61 6e 64 20 63 6c | and rea|d and cl|
|00000d80| 65 61 72 65 64 20 62 79 | 20 74 68 65 20 61 70 70 |eared by| the app|
|00000d90| 6c 69 63 61 74 69 6f 6e | 2e 20 4f 74 68 65 72 20 |lication|. Other |
|00000da0| 62 69 74 73 20 69 6e 20 | 74 68 65 20 66 6f 75 72 |bits in |the four|
|00000db0| 74 68 20 62 79 74 65 20 | 28 62 69 74 73 20 35 d0 |th byte |(bits 5.|
|00000dc0| 34 20 61 6e 64 20 31 d0 | 30 29 20 6d 75 73 74 20 |4 and 1.|0) must |
|00000dd0| 62 65 20 7a 65 72 6f 2e | 0d 54 68 65 20 73 65 63 |be zero.|.The sec|
|00000de0| 6f 6e 64 20 6c 6f 6e 67 | 77 6f 72 64 20 6f 66 20 |ond long|word of |
|00000df0| 74 68 65 20 68 65 61 64 | 65 72 20 63 6f 6e 74 61 |the head|er conta|
|00000e00| 69 6e 73 20 74 68 65 20 | 72 65 73 6f 6c 75 74 69 |ins the |resoluti|
|00000e10| 6f 6e 2e 0d 46 69 67 75 | 72 65 20 33 20 46 6f 72 |on..Figu|re 3 For|
|00000e20| 6d 61 74 20 6f 66 20 48 | 65 61 64 65 72 d5 73 20 |mat of H|eader.s |
|00000e30| 53 65 63 6f 6e 64 20 4c | 6f 6e 67 77 6f 72 64 20 |Second L|ongword |
|00000e40| 20 0d 41 6e 20 45 6e 67 | 6c 69 73 68 20 61 6e 64 | .An Eng|lish and|
|00000e50| 20 6d 65 74 72 69 63 20 | 66 6c 61 67 20 28 6d 2c | metric |flag (m,|
|00000e60| 20 62 69 74 20 33 31 29 | 20 69 6e 64 69 63 61 74 | bit 31)| indicat|
|00000e70| 65 73 20 77 68 65 74 68 | 65 72 20 6d 65 61 73 75 |es wheth|er measu|
|00000e80| 72 65 6d 65 6e 74 73 20 | 61 72 65 20 69 6e 20 45 |rements |are in E|
|00000e90| 6e 67 6c 69 73 68 20 28 | 74 68 65 20 62 69 74 20 |nglish (|the bit |
|00000ea0| 69 73 20 61 20 30 29 20 | 6f 72 20 6d 65 74 72 69 |is a 0) |or metri|
|00000eb0| 63 20 28 74 68 65 20 62 | 69 74 20 69 73 20 61 20 |c (the b|it is a |
|00000ec0| 31 29 20 75 6e 69 74 73 | 2e 20 4f 74 68 65 72 20 |1) units|. Other |
|00000ed0| 62 69 74 73 20 69 6e 20 | 74 68 65 20 66 69 72 73 |bits in |the firs|
|00000ee0| 74 20 62 79 74 65 20 28 | 62 69 74 73 20 33 30 d0 |t byte (|bits 30.|
|00000ef0| 32 38 29 20 6d 75 73 74 | 20 62 65 20 7a 65 72 6f |28) must| be zero|
|00000f00| 2e 20 41 20 31 32 2d 62 | 69 74 20 66 69 65 6c 64 |. A 12-b|it field|
|00000f10| 20 28 61 6e 67 75 6c 61 | 72 2c 20 62 69 74 73 20 | (angula|r, bits |
|00000f20| 32 37 d0 31 36 29 20 69 | 6e 64 69 63 61 74 65 73 |27.16) i|ndicates|
|00000f30| 20 74 68 65 20 61 6e 67 | 75 6c 61 72 20 72 65 73 | the ang|ular res|
|00000f40| 6f 6c 75 74 69 6f 6e 20 | 73 65 6e 73 65 64 20 62 |olution |sensed b|
|00000f50| 79 20 74 68 65 20 70 6f | 69 6e 74 69 6e 67 20 64 |y the po|inting d|
|00000f60| 65 76 69 63 65 3b 20 74 | 68 65 20 76 61 6c 75 65 |evice; t|he value|
|00000f70| 20 69 6e 20 74 68 69 73 | 20 66 69 65 6c 64 20 69 | in this| field i|
|00000f80| 6e 64 69 63 61 74 65 73 | 20 74 68 65 20 6e 75 6d |ndicates| the num|
|00000f90| 62 65 72 20 6f 66 20 61 | 6e 67 75 6c 61 72 20 69 |ber of a|ngular i|
|00000fa0| 6e 63 6c 69 6e 61 74 69 | 6f 6e 73 20 74 68 61 74 |nclinati|ons that|
|00000fb0| 20 63 61 6e 20 62 65 20 | 73 65 6e 73 65 64 3b 20 | can be |sensed; |
|00000fc0| 74 68 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |the appl|ication |
|00000fd0| 63 61 6e 20 6d 61 70 20 | 74 68 69 73 20 72 61 6e |can map |this ran|
|00000fe0| 67 65 20 69 6e 74 6f 20 | 61 20 66 75 6c 6c 20 33 |ge into |a full 3|
|00000ff0| 36 30 a1 2c 20 31 38 30 | a1 2c 20 6f 72 20 61 63 |60., 180|., or ac|
|00001000| 74 75 61 6c 20 69 6e 63 | 6c 69 6e 61 74 69 6f 6e |tual inc|lination|
|00001010| 20 72 61 6e 67 65 20 6f | 66 20 74 68 65 20 64 65 | range o|f the de|
|00001020| 76 69 63 65 20 28 74 68 | 69 73 20 66 69 65 6c 64 |vice (th|is field|
|00001030| 20 69 73 20 6d 65 61 6e | 69 6e 67 66 75 6c 20 6f | is mean|ingful o|
|00001040| 6e 6c 79 20 69 66 20 74 | 68 65 20 6f 72 69 65 6e |nly if t|he orien|
|00001050| 74 61 74 69 6f 6e 20 66 | 6f 72 6d 61 74 20 72 65 |tation f|ormat re|
|00001060| 70 6f 72 74 73 20 61 6e | 67 75 6c 61 72 20 6d 65 |ports an|gular me|
|00001070| 61 73 75 72 65 2c 20 74 | 68 61 74 20 69 73 2c 20 |asure, t|hat is, |
|00001080| 69 66 20 74 69 6c 74 20 | 6f 72 20 61 6e 20 61 74 |if tilt |or an at|
|00001090| 74 69 74 75 64 65 20 6d | 61 74 72 69 78 20 69 73 |titude m|atrix is|
|000010a0| 20 73 75 70 70 6f 72 74 | 65 64 29 2e 20 41 20 31 | support|ed). A 1|
|000010b0| 36 2d 62 69 74 20 66 69 | 65 6c 64 20 28 73 70 61 |6-bit fi|eld (spa|
|000010c0| 63 65 2c 20 62 69 74 73 | 20 31 35 d0 30 29 20 73 |ce, bits| 15.0) s|
|000010d0| 70 65 63 69 66 69 65 73 | 20 74 68 65 20 73 70 61 |pecifies| the spa|
|000010e0| 74 69 61 6c 20 72 65 73 | 6f 6c 75 74 69 6f 6e 20 |tial res|olution |
|000010f0| 6f 66 20 74 68 65 20 64 | 65 76 69 63 65 20 28 74 |of the d|evice (t|
|00001100| 68 65 20 75 6e 69 74 73 | 20 6f 66 20 6d 65 61 73 |he units| of meas|
|00001110| 75 72 65 20 75 73 65 64 | 20 74 6f 20 73 70 65 63 |ure used| to spec|
|00001120| 69 66 79 20 74 68 65 20 | 64 69 6d 65 6e 73 69 6f |ify the |dimensio|
|00001130| 6e 20 6f 66 20 74 68 65 | 20 73 65 6e 73 65 20 61 |n of the| sense a|
|00001140| 72 65 61 20 61 6e 64 20 | 6f 72 69 67 69 6e 20 6f |rea and |origin o|
|00001150| 66 66 73 65 74 20 28 64 | 69 73 70 6c 61 63 65 6d |ffset (d|isplacem|
|00001160| 65 6e 74 29 20 20 6c 6f | 6e 67 77 6f 72 64 73 20 |ent) lo|ngwords |
|00001170| 69 6e 20 74 68 65 20 68 | 65 61 64 65 72 20 61 6e |in the h|eader an|
|00001180| 64 20 69 6e 20 74 68 65 | 20 63 6f 6f 72 64 69 6e |d in the| coordin|
|00001190| 61 74 65 20 6c 6f 6e 67 | 77 6f 72 64 73 20 69 6e |ate long|words in|
|000011a0| 20 74 68 65 20 63 75 72 | 73 6f 72 20 62 6c 6f 63 | the cur|sor bloc|
|000011b0| 6b 73 3a 20 20 75 6e 69 | 74 73 20 70 65 72 20 69 |ks: uni|ts per i|
|000011c0| 6e 63 68 20 66 6f 72 20 | 45 6e 67 6c 69 73 68 20 |nch for |English |
|000011d0| 61 6e 64 20 75 6e 69 74 | 73 20 70 65 72 20 63 65 |and unit|s per ce|
|000011e0| 6e 74 69 6d 65 74 65 72 | 20 66 6f 72 20 6d 65 74 |ntimeter| for met|
|000011f0| 72 69 63 29 2e 20 54 68 | 75 73 2c 20 66 6f 72 20 |ric). Th|us, for |
|00001200| 65 78 61 6d 70 6c 65 2c | 20 31 30 30 30 20 69 6e |example,| 1000 in|
|00001210| 20 74 68 69 73 20 66 69 | 65 6c 64 20 77 6f 75 6c | this fi|eld woul|
|00001220| 64 20 69 6e 64 69 63 61 | 74 65 20 74 68 61 74 20 |d indica|te that |
|00001230| 64 69 6d 65 6e 73 69 6f | 6e 73 20 61 72 65 20 73 |dimensio|ns are s|
|00001240| 70 65 63 69 66 69 65 64 | 20 69 6e 20 30 2e 30 30 |pecified| in 0.00|
|00001250| 31 20 69 6e 63 68 65 73 | 2e 0d 54 68 65 20 74 68 |1 inches|..The th|
|00001260| 69 72 64 20 6c 6f 6e 67 | 77 6f 72 64 20 6f 66 20 |ird long|word of |
|00001270| 74 68 65 20 68 65 61 64 | 65 72 20 63 6f 6e 74 61 |the head|er conta|
|00001280| 69 6e 73 20 74 68 65 20 | 58 20 61 78 69 73 20 64 |ins the |X axis d|
|00001290| 69 6d 65 6e 73 69 6f 6e | 20 6f 66 20 74 68 65 20 |imension| of the |
|000012a0| 73 65 6e 73 65 20 61 72 | 65 61 2c 20 74 68 65 20 |sense ar|ea, the |
|000012b0| 66 6f 75 72 74 68 20 6c | 6f 6e 67 77 6f 72 64 20 |fourth l|ongword |
|000012c0| 74 68 65 20 59 20 61 78 | 69 73 20 64 69 6d 65 6e |the Y ax|is dimen|
|000012d0| 73 69 6f 6e 20 6f 66 20 | 74 68 65 20 73 65 6e 73 |sion of |the sens|
|000012e0| 65 20 61 72 65 61 2c 20 | 61 6e 64 20 74 68 65 20 |e area, |and the |
|000012f0| 66 69 66 74 68 20 6c 6f | 6e 67 77 6f 72 64 20 74 |fifth lo|ngword t|
|00001300| 68 65 20 5a 20 61 78 69 | 73 20 64 69 6d 65 6e 73 |he Z axi|s dimens|
|00001310| 69 6f 6e 20 6f 66 20 74 | 68 65 20 73 65 6e 73 65 |ion of t|he sense|
|00001320| 20 61 72 65 61 2e 20 28 | 49 66 20 61 20 74 61 62 | area. (|If a tab|
|00001330| 6c 65 74 20 73 75 70 70 | 6f 72 74 73 20 62 6f 74 |let supp|orts bot|
|00001340| 68 20 70 6f 72 74 72 61 | 69 74 20 61 6e 64 20 6c |h portra|it and l|
|00001350| 61 6e 64 73 63 61 70 65 | 20 6d 6f 64 65 73 2c 20 |andscape| modes, |
|00001360| 74 68 69 73 20 69 73 20 | 72 65 66 6c 65 63 74 65 |this is |reflecte|
|00001370| 64 20 69 6e 20 74 68 65 | 20 76 61 6c 75 65 73 20 |d in the| values |
|00001380| 69 6e 20 74 68 65 20 58 | 20 61 6e 64 20 59 20 64 |in the X| and Y d|
|00001390| 69 6d 65 6e 73 69 6f 6e | 73 2e 29 0d 54 68 65 20 |imension|s.).The |
|000013a0| 73 69 78 74 68 20 6c 6f | 6e 67 77 6f 72 64 20 6f |sixth lo|ngword o|
|000013b0| 66 20 74 68 65 20 68 65 | 61 64 65 72 20 63 6f 6e |f the he|ader con|
|000013c0| 74 61 69 6e 73 20 74 68 | 65 20 58 20 61 78 69 73 |tains th|e X axis|
|000013d0| 20 64 69 73 70 6c 61 63 | 65 6d 65 6e 74 20 6f 66 | displac|ement of|
|000013e0| 20 74 68 65 20 73 65 6e | 73 65 20 61 72 65 61 2c | the sen|se area,|
|000013f0| 20 74 68 65 20 73 65 76 | 65 6e 74 68 20 6c 6f 6e | the sev|enth lon|
|00001400| 67 77 6f 72 64 20 74 68 | 65 20 59 20 61 78 69 73 |gword th|e Y axis|
|00001410| 20 64 69 73 70 6c 61 63 | 65 6d 65 6e 74 20 6f 66 | displac|ement of|
|00001420| 20 74 68 65 20 73 65 6e | 73 65 20 61 72 65 61 2c | the sen|se area,|
|00001430| 20 61 6e 64 20 74 68 65 | 20 65 69 67 68 74 68 20 | and the| eighth |
|00001440| 6c 6f 6e 67 77 6f 72 64 | 20 74 68 65 20 5a 20 61 |longword| the Z a|
|00001450| 78 69 73 20 64 69 73 70 | 6c 61 63 65 6d 65 6e 74 |xis disp|lacement|
|00001460| 20 6f 66 20 74 68 65 20 | 73 65 6e 73 65 20 61 72 | of the |sense ar|
|00001470| 65 61 2e 20 54 68 65 73 | 65 20 61 78 69 73 20 64 |ea. Thes|e axis d|
|00001480| 69 73 70 6c 61 63 65 6d | 65 6e 74 73 20 73 70 65 |isplacem|ents spe|
|00001490| 63 69 66 79 20 74 68 65 | 20 58 2c 20 59 2c 20 61 |cify the| X, Y, a|
|000014a0| 6e 64 20 5a 20 63 6f 6f | 72 64 69 6e 61 74 65 20 |nd Z coo|rdinate |
|000014b0| 76 61 6c 75 65 73 2c 20 | 72 65 73 70 65 63 74 69 |values, |respecti|
|000014c0| 76 65 6c 79 2c 20 61 74 | 20 74 68 65 20 73 65 6e |vely, at| the sen|
|000014d0| 73 65 20 61 72 65 61 20 | 6f 72 69 67 69 6e 2e 20 |se area |origin. |
|000014e0| 54 68 65 20 73 65 6e 73 | 65 20 61 72 65 61 20 6f |The sens|e area o|
|000014f0| 72 69 67 69 6e 20 69 73 | 20 61 74 20 74 68 65 20 |rigin is| at the |
|00001500| 6c 6f 77 65 72 20 6c 65 | 66 74 20 69 6e 20 61 20 |lower le|ft in a |
|00001510| 32 2d 44 20 73 65 6e 73 | 65 20 61 72 65 61 20 73 |2-D sens|e area s|
|00001520| 75 63 68 20 61 73 20 61 | 20 74 61 62 6c 65 74 2e |uch as a| tablet.|
|00001530| 20 54 68 65 20 64 69 6d | 65 6e 73 69 6f 6e 73 20 | The dim|ensions |
|00001540| 6f 66 20 74 68 65 20 73 | 65 6e 73 65 20 61 72 65 |of the s|ense are|
|00001550| 61 20 61 72 65 20 66 72 | 6f 6d 20 61 20 72 65 66 |a are fr|om a ref|
|00001560| 65 72 65 6e 63 65 20 70 | 6f 69 6e 74 3b 20 74 68 |erence p|oint; th|
|00001570| 65 20 64 69 73 70 6c 61 | 63 65 6d 65 6e 74 73 20 |e displa|cements |
|00001580| 61 72 65 20 74 68 65 20 | 6d 69 6e 69 6d 75 6d 20 |are the |minimum |
|00001590| 76 61 6c 75 65 73 20 74 | 68 65 20 64 65 76 69 63 |values t|he devic|
|000015a0| 65 20 72 65 74 75 72 6e | 73 2e 0d 54 68 65 20 6e |e return|s..The n|
|000015b0| 69 6e 74 68 20 6c 6f 6e | 67 77 6f 72 64 20 6f 66 |inth lon|gword of|
|000015c0| 20 74 68 65 20 68 65 61 | 64 65 72 20 63 6f 6e 74 | the hea|der cont|
|000015d0| 61 69 6e 73 20 61 20 70 | 6f 69 6e 74 65 72 20 74 |ains a p|ointer t|
|000015e0| 6f 20 74 68 65 20 66 69 | 72 73 74 20 62 79 74 65 |o the fi|rst byte|
|000015f0| 20 6f 66 20 61 20 62 6c | 6f 63 6b 20 74 68 61 74 | of a bl|ock that|
|00001600| 20 73 70 65 63 69 66 69 | 65 73 20 64 65 76 69 63 | specifi|es devic|
|00001610| 65 2d 73 70 65 63 69 66 | 69 63 20 65 78 74 65 6e |e-specif|ic exten|
|00001620| 73 69 6f 6e 73 2e 20 46 | 6f 72 20 65 78 61 6d 70 |sions. F|or examp|
|00001630| 6c 65 2c 20 69 66 20 74 | 68 65 20 64 65 76 69 63 |le, if t|he devic|
|00001640| 65 20 69 73 20 69 6e 74 | 65 6c 6c 69 67 65 6e 74 |e is int|elligent|
|00001650| 2c 20 74 68 69 73 20 6d | 61 79 20 70 6f 69 6e 74 |, this m|ay point|
|00001660| 20 74 6f 20 61 6e 20 61 | 72 65 61 20 74 68 61 74 | to an a|rea that|
|00001670| 20 63 6f 6e 74 61 69 6e | 73 20 61 20 63 6f 6d 6d | contain|s a comm|
|00001680| 61 6e 64 20 62 75 66 66 | 65 72 20 66 6f 72 20 70 |and buff|er for p|
|00001690| 72 6f 67 72 61 6d 6d 69 | 6e 67 20 74 68 65 20 64 |rogrammi|ng the d|
|000016a0| 65 76 69 63 65 2e 0d 54 | 68 65 20 74 65 6e 74 68 |evice..T|he tenth|
|000016b0| 20 6c 6f 6e 67 77 6f 72 | 64 20 6f 66 20 74 68 65 | longwor|d of the|
|000016c0| 20 68 65 61 64 65 72 20 | 63 6f 6e 74 61 69 6e 73 | header |contains|
|000016d0| 20 66 6f 75 72 20 41 53 | 43 49 49 20 63 68 61 72 | four AS|CII char|
|000016e0| 61 63 74 65 72 73 20 69 | 64 65 6e 74 69 66 79 69 |acters i|dentifyi|
|000016f0| 6e 67 20 74 68 65 20 64 | 65 76 69 63 65 20 74 79 |ng the d|evice ty|
|00001700| 70 65 2c 20 69 6e 20 74 | 68 69 73 20 63 61 73 65 |pe, in t|his case|
|00001710| 20 27 54 42 4c 54 27 2e | 0d 43 75 72 73 6f 72 20 | 'TBLT'.|.Cursor |
|00001720| 42 6c 6f 63 6b 0d 46 6f | 72 20 65 61 63 68 20 63 |Block.Fo|r each c|
|00001730| 75 72 73 6f 72 2c 20 74 | 68 65 20 66 6f 6c 6c 6f |ursor, t|he follo|
|00001740| 77 69 6e 67 20 62 6c 6f | 63 6b 20 6f 66 20 69 6e |wing blo|ck of in|
|00001750| 66 6f 72 6d 61 74 69 6f | 6e 20 69 73 20 70 72 6f |formatio|n is pro|
|00001760| 76 69 64 65 64 2e 0d 54 | 68 65 20 66 69 72 73 74 |vided..T|he first|
|00001770| 20 6c 6f 6e 67 77 6f 72 | 64 20 63 6f 6e 74 61 69 | longwor|d contai|
|00001780| 6e 73 20 61 20 74 72 61 | 6e 73 64 75 63 65 72 20 |ns a tra|nsducer |
|00001790| 74 79 70 65 2c 20 63 61 | 70 61 62 69 6c 69 74 79 |type, ca|pability|
|000017a0| 20 66 6c 61 67 73 2c 20 | 70 72 65 73 73 75 72 65 | flags, |pressure|
|000017b0| 20 72 65 73 6f 6c 75 74 | 69 6f 6e 2c 20 61 6e 64 | resolut|ion, and|
|000017c0| 20 6f 72 69 65 6e 74 61 | 74 69 6f 6e 20 66 6f 72 | orienta|tion for|
|000017d0| 6d 61 74 2c 20 61 73 20 | 69 6c 6c 75 73 74 72 61 |mat, as |illustra|
|000017e0| 74 65 64 20 69 6e 20 46 | 69 67 75 72 65 20 34 2e |ted in F|igure 4.|
|000017f0| 0d 46 69 67 75 72 65 20 | 34 20 46 6f 72 6d 61 74 |.Figure |4 Format|
|00001800| 20 6f 66 20 43 75 72 73 | 6f 72 20 42 6c 6f 63 6b | of Curs|or Block|
|00001810| d5 73 20 46 69 72 73 74 | 20 4c 6f 6e 67 77 6f 72 |.s First| Longwor|
|00001820| 64 20 20 0d 54 68 65 20 | 74 77 6f 2d 62 69 74 20 |d .The |two-bit |
|00001830| 74 72 61 6e 73 64 75 63 | 65 72 20 74 79 70 65 20 |transduc|er type |
|00001840| 66 69 65 6c 64 20 28 74 | 2c 20 62 69 74 73 20 32 |field (t|, bits 2|
|00001850| 39 d0 32 38 29 20 73 70 | 65 63 69 66 69 65 73 20 |9.28) sp|ecifies |
|00001860| 74 68 65 20 70 6f 69 6e | 74 69 6e 67 20 64 65 76 |the poin|ting dev|
|00001870| 69 63 65 3a 20 20 7a 65 | 72 6f 20 69 6e 64 69 63 |ice: ze|ro indic|
|00001880| 61 74 65 73 20 74 68 61 | 74 20 74 68 65 20 74 79 |ates tha|t the ty|
|00001890| 70 65 20 69 73 20 75 6e | 6b 6e 6f 77 6e 2c 20 6f |pe is un|known, o|
|000018a0| 6e 65 20 69 6e 64 69 63 | 61 74 65 73 20 70 65 6e |ne indic|ates pen|
|000018b0| 2c 20 61 6e 64 20 74 77 | 6f 20 69 6e 64 69 63 61 |, and tw|o indica|
|000018c0| 74 65 73 20 61 20 63 75 | 72 73 6f 72 2e 20 54 68 |tes a cu|rsor. Th|
|000018d0| 72 65 65 20 66 6c 61 67 | 73 20 28 64 69 73 70 20 |ree flag|s (disp |
|000018e0| 78 2c 20 64 69 73 70 20 | 79 2c 20 61 6e 64 20 64 |x, disp |y, and d|
|000018f0| 69 73 70 20 7a 3b 20 62 | 69 74 73 20 32 36 2c 20 |isp z; b|its 26, |
|00001900| 32 35 2c 20 61 6e 64 20 | 32 34 29 20 73 70 65 63 |25, and |24) spec|
|00001910| 69 66 79 20 74 68 65 20 | 63 61 70 61 62 69 6c 69 |ify the |capabili|
|00001920| 74 79 20 74 6f 20 73 65 | 6e 73 65 20 64 69 73 70 |ty to se|nse disp|
|00001930| 6c 61 63 65 6d 65 6e 74 | 73 20 69 6e 20 74 68 65 |lacement|s in the|
|00001940| 20 58 2c 20 59 2c 20 61 | 6e 64 20 5a 20 64 69 6d | X, Y, a|nd Z dim|
|00001950| 65 6e 73 69 6f 6e 73 2c | 20 77 69 74 68 20 61 20 |ensions,| with a |
|00001960| 6f 6e 65 20 69 6e 64 69 | 63 61 74 69 6e 67 20 74 |one indi|cating t|
|00001970| 68 65 20 63 61 70 61 62 | 69 6c 69 74 79 20 69 73 |he capab|ility is|
|00001980| 20 70 72 65 73 65 6e 74 | 2e 20 41 20 66 6f 75 72 | present|. A four|
|00001990| 2d 62 69 74 20 66 69 65 | 6c 64 20 28 6f 72 69 65 |-bit fie|ld (orie|
|000019a0| 6e 74 2c 20 62 69 74 73 | 20 31 39 d0 31 36 29 20 |nt, bits| 19.16) |
|000019b0| 69 6e 64 69 63 61 74 65 | 73 20 74 68 65 20 66 6f |indicate|s the fo|
|000019c0| 72 6d 61 74 20 6f 66 20 | 6f 72 69 65 6e 74 61 74 |rmat of |orientat|
|000019d0| 69 6f 6e 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 3a |ion info|rmation:|
|000019e0| 20 20 30 20 69 6e 64 69 | 63 61 74 65 73 20 6e 6f | 0 indi|cates no|
|000019f0| 20 6f 72 69 65 6e 74 61 | 74 69 6f 6e 20 69 6e 66 | orienta|tion inf|
|00001a00| 6f 72 6d 61 74 69 6f 6e | 20 69 73 20 70 72 6f 76 |ormation| is prov|
|00001a10| 69 64 65 64 2c 20 31 20 | 69 6e 64 69 63 61 74 65 |ided, 1 |indicate|
|00001a20| 73 20 61 6e 20 61 74 74 | 69 74 75 64 65 20 6d 61 |s an att|itude ma|
|00001a30| 74 72 69 78 20 69 73 20 | 73 75 70 70 6c 69 65 64 |trix is |supplied|
|00001a40| 2c 20 32 20 69 6e 64 69 | 63 61 74 65 73 20 70 65 |, 2 indi|cates pe|
|00001a50| 6e 20 74 69 6c 74 20 66 | 72 6f 6d 20 76 65 72 74 |n tilt f|rom vert|
|00001a60| 69 63 61 6c 2c 20 61 6e | 64 20 32 33 d0 32 30 20 |ical, an|d 23.20 |
|00001a70| 61 72 65 20 72 65 73 65 | 72 76 65 64 20 66 6f 72 |are rese|rved for|
|00001a80| 20 61 64 64 69 74 69 6f | 6e 61 6c 20 66 6f 72 6d | additio|nal form|
|00001a90| 61 74 73 2e 20 41 20 66 | 6c 61 67 20 28 70 2c 20 |ats. A f|lag (p, |
|00001aa0| 62 69 74 20 32 37 29 20 | 69 6e 64 69 63 61 74 65 |bit 27) |indicate|
|00001ab0| 73 20 77 68 65 74 68 65 | 72 20 74 61 6e 67 65 6e |s whethe|r tangen|
|00001ac0| 74 69 61 6c 20 70 72 65 | 73 73 75 72 65 20 69 73 |tial pre|ssure is|
|00001ad0| 20 73 65 6e 73 65 64 2c | 20 77 69 74 68 20 61 20 | sensed,| with a |
|00001ae0| 6f 6e 65 20 69 6e 64 69 | 63 61 74 69 6e 67 20 70 |one indi|cating p|
|00001af0| 72 65 73 73 75 72 65 20 | 69 73 20 73 65 6e 73 65 |ressure |is sense|
|00001b00| 64 2e 20 41 20 31 36 2d | 62 69 74 20 66 69 65 6c |d. A 16-|bit fiel|
|00001b10| 64 20 28 70 72 65 73 73 | 75 72 65 20 72 65 73 6f |d (press|ure reso|
|00001b20| 6c 75 74 69 6f 6e 29 20 | 69 6e 64 69 63 61 74 65 |lution) |indicate|
|00001b30| 73 20 74 68 65 20 6e 75 | 6d 62 65 72 20 6f 66 20 |s the nu|mber of |
|00001b40| 70 72 65 73 73 75 72 65 | 20 6c 65 76 65 6c 73 20 |pressure| levels |
|00001b50| 74 68 61 74 20 63 61 6e | 20 62 65 20 73 65 6e 73 |that can| be sens|
|00001b60| 65 64 3b 20 7a 65 72 6f | 20 69 6e 20 74 68 69 73 |ed; zero| in this|
|00001b70| 20 66 69 65 6c 64 20 6d | 65 61 6e 73 20 74 68 61 | field m|eans tha|
|00001b80| 74 20 70 72 65 73 73 75 | 72 65 20 69 73 20 6e 6f |t pressu|re is no|
|00001b90| 74 20 73 65 6e 73 65 64 | 2e 20 54 68 69 73 20 6e |t sensed|. This n|
|00001ba0| 75 6d 62 65 72 20 61 70 | 70 6c 69 65 73 20 74 6f |umber ap|plies to|
|00001bb0| 20 62 6f 74 68 20 6e 6f | 72 6d 61 6c 20 61 6e 64 | both no|rmal and|
|00001bc0| 20 74 61 6e 67 65 6e 74 | 69 61 6c 20 70 72 65 73 | tangent|ial pres|
|00001bd0| 73 75 72 65 2e 0d 41 73 | 20 69 6c 6c 75 73 74 72 |sure..As| illustr|
|00001be0| 61 74 65 64 20 69 6e 20 | 46 69 67 75 72 65 73 20 |ated in |Figures |
|00001bf0| 35 20 61 6e 64 20 36 2c | 20 74 68 65 20 73 65 63 |5 and 6,| the sec|
|00001c00| 6f 6e 64 20 61 6e 64 20 | 74 68 69 72 64 20 6c 6f |ond and |third lo|
|00001c10| 6e 67 77 6f 72 64 73 20 | 6f 66 20 74 68 65 20 63 |ngwords |of the c|
|00001c20| 75 72 73 6f 72 20 62 6c | 6f 63 6b 20 63 6f 6e 74 |ursor bl|ock cont|
|00001c30| 61 69 6e 2c 20 72 65 73 | 70 65 63 74 69 76 65 6c |ain, res|pectivel|
|00001c40| 79 2c 20 74 68 65 20 78 | 20 73 63 61 6c 65 20 61 |y, the x| scale a|
|00001c50| 6e 64 20 74 72 61 6e 73 | 6c 61 74 69 6f 6e 20 66 |nd trans|lation f|
|00001c60| 61 63 74 6f 72 73 20 61 | 6e 64 20 79 20 73 63 61 |actors a|nd y sca|
|00001c70| 6c 65 20 61 6e 64 20 74 | 72 61 6e 73 6c 61 74 69 |le and t|ranslati|
|00001c80| 6f 6e 20 66 61 63 74 6f | 72 73 20 74 6f 20 75 73 |on facto|rs to us|
|00001c90| 65 20 77 68 65 6e 20 6d | 61 70 70 69 6e 67 20 62 |e when m|apping b|
|00001ca0| 65 74 77 65 65 6e 20 61 | 20 73 63 72 65 65 6e 20 |etween a| screen |
|00001cb0| 77 69 6e 64 6f 77 20 61 | 6e 64 20 61 6e 20 61 72 |window a|nd an ar|
|00001cc0| 65 61 20 6f 6e 20 74 68 | 65 20 74 61 62 6c 65 74 |ea on th|e tablet|
|00001cd0| 2e 20 54 68 65 20 73 63 | 61 6c 69 6e 67 20 61 6e |. The sc|aling an|
|00001ce0| 64 20 74 72 61 6e 73 6c | 61 74 69 6f 6e 20 66 61 |d transl|ation fa|
|00001cf0| 63 74 6f 72 73 20 61 72 | 65 20 70 72 6f 76 69 64 |ctors ar|e provid|
|00001d00| 65 64 20 62 79 20 74 68 | 65 20 64 72 69 76 65 72 |ed by th|e driver|
|00001d10| 2e 20 28 54 79 70 69 63 | 61 6c 6c 79 20 74 68 65 |. (Typic|ally the|
|00001d20| 20 66 61 63 74 6f 72 73 | 20 61 72 65 20 63 61 6c | factors| are cal|
|00001d30| 63 75 6c 61 74 65 64 20 | 66 72 6f 6d 20 74 68 65 |culated |from the|
|00001d40| 20 74 61 62 6c 65 74 20 | 74 6f 20 73 63 72 65 65 | tablet |to scree|
|00001d50| 6e 20 6d 61 70 70 69 6e | 67 20 73 65 74 20 62 79 |n mappin|g set by|
|00001d60| 20 74 68 65 20 75 73 65 | 72 2e 29 20 41 6e 20 61 | the use|r.) An a|
|00001d70| 70 70 6c 69 63 61 74 69 | 6f 6e 20 63 61 6e 20 72 |pplicati|on can r|
|00001d80| 65 61 64 20 74 68 65 73 | 65 20 66 61 63 74 6f 72 |ead thes|e factor|
|00001d90| 73 20 6f 72 20 69 74 20 | 63 61 6e 20 73 61 76 65 |s or it |can save|
|00001da0| 20 61 6e 64 20 72 65 70 | 6c 61 63 65 20 74 68 65 | and rep|lace the|
|00001db0| 6d 20 77 69 74 68 20 69 | 74 73 20 6f 77 6e 2e 20 |m with i|ts own. |
|00001dc0| 54 68 65 20 73 61 76 65 | 64 20 66 61 63 74 6f 72 |The save|d factor|
|00001dd0| 73 20 73 68 6f 75 6c 64 | 20 62 65 20 72 65 73 74 |s should| be rest|
|00001de0| 6f 72 65 64 20 77 68 65 | 6e 20 74 68 65 20 61 70 |ored whe|n the ap|
|00001df0| 70 6c 69 63 61 74 69 6f | 6e 20 74 65 72 6d 69 6e |plicatio|n termin|
|00001e00| 61 74 65 73 2e 0d 46 69 | 67 75 72 65 20 35 20 46 |ates..Fi|gure 5 F|
|00001e10| 6f 72 6d 61 74 20 6f 66 | 20 43 75 72 73 6f 72 20 |ormat of| Cursor |
|00001e20| 42 6c 6f 63 6b d5 73 20 | 53 65 63 6f 6e 64 20 4c |Block.s |Second L|
|00001e30| 6f 6e 67 77 6f 72 64 20 | 20 0d 46 69 67 75 72 65 |ongword | .Figure|
|00001e40| 20 36 20 46 6f 72 6d 61 | 74 20 6f 66 20 43 75 72 | 6 Forma|t of Cur|
|00001e50| 73 6f 72 20 42 6c 6f 63 | 6b d5 73 20 54 68 69 72 |sor Bloc|k.s Thir|
|00001e60| 64 20 4c 6f 6e 67 77 6f | 72 64 20 20 0d 54 68 65 |d Longwo|rd .The|
|00001e70| 20 78 20 61 6e 64 20 79 | 20 73 63 61 6c 65 20 66 | x and y| scale f|
|00001e80| 61 63 74 6f 72 73 20 61 | 72 65 20 70 6f 73 69 74 |actors a|re posit|
|00001e90| 69 76 65 20 66 72 61 63 | 74 69 6f 6e 73 20 28 72 |ive frac|tions (r|
|00001ea0| 65 6c 61 74 65 64 20 74 | 6f 20 74 68 65 20 7a 6f |elated t|o the zo|
|00001eb0| 6f 6d 20 66 61 63 74 6f | 72 20 6f 66 20 74 68 65 |om facto|r of the|
|00001ec0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 29 20 61 6e | applica|tion) an|
|00001ed0| 64 20 74 68 65 20 74 72 | 61 6e 73 6c 61 74 69 6f |d the tr|anslatio|
|00001ee0| 6e 20 76 61 6c 75 65 73 | 20 61 72 65 20 73 75 63 |n values| are suc|
|00001ef0| 68 20 74 68 61 74 20 74 | 68 65 20 72 65 6c 61 74 |h that t|he relat|
|00001f00| 69 6f 6e 20 62 65 74 77 | 65 65 6e 20 74 68 65 20 |ion betw|een the |
|00001f10| 28 6d 6f 75 73 65 29 20 | 63 75 72 73 6f 72 20 70 |(mouse) |cursor p|
|00001f20| 6f 73 69 74 69 6f 6e 20 | 61 6e 64 20 74 68 65 20 |osition |and the |
|00001f30| 74 61 62 6c 65 74 20 63 | 6f 6f 72 64 69 6e 61 74 |tablet c|oordinat|
|00001f40| 65 73 20 61 72 65 20 61 | 73 20 66 6f 6c 6c 6f 77 |es are a|s follow|
|00001f50| 73 3a 0d 20 20 20 20 20 | 20 20 20 6d 6f 75 73 65 |s:. | mouse|
|00001f60| 20 78 20 3d 20 28 74 61 | 62 6c 65 74 20 68 6f 72 | x = (ta|blet hor|
|00001f70| 69 7a 6f 6e 74 61 6c 29 | 20 2a 20 28 78 20 73 63 |izontal)| * (x sc|
|00001f80| 61 6c 65 29 20 2b 20 28 | 78 20 74 72 61 6e 73 6c |ale) + (|x transl|
|00001f90| 61 74 69 6f 6e 29 0d 20 | 20 20 20 20 20 20 20 6d |ation). | m|
|00001fa0| 6f 75 73 65 20 79 20 3d | 20 2d 28 74 61 62 6c 65 |ouse y =| -(table|
|00001fb0| 74 20 76 65 72 74 69 63 | 61 6c 29 20 2a 20 28 79 |t vertic|al) * (y|
|00001fc0| 20 73 63 61 6c 65 29 20 | 2b 20 28 79 20 74 72 61 | scale) |+ (y tra|
|00001fd0| 6e 73 6c 61 74 69 6f 6e | 29 0d 54 68 65 20 6e 65 |nslation|).The ne|
|00001fe0| 67 61 74 69 76 65 20 69 | 6e 20 74 68 65 20 79 20 |gative i|n the y |
|00001ff0| 65 71 75 61 74 69 6f 6e | 20 63 6f 6d 70 65 6e 73 |equation| compens|
|00002000| 61 74 65 73 20 66 6f 72 | 20 74 68 65 20 64 69 66 |ates for| the dif|
|00002010| 66 65 72 65 6e 74 20 6f | 72 69 65 6e 74 61 74 69 |ferent o|rientati|
|00002020| 6f 6e 20 6f 66 20 74 68 | 65 20 74 61 62 6c 65 74 |on of th|e tablet|
|00002030| 20 63 6f 6f 72 64 69 6e | 61 74 65 20 6f 72 69 67 | coordin|ate orig|
|00002040| 69 6e 20 61 6e 64 20 74 | 68 65 20 73 63 72 65 65 |in and t|he scree|
|00002050| 6e 20 63 6f 6f 72 64 69 | 6e 61 74 65 20 6f 72 69 |n coordi|nate ori|
|00002060| 67 69 6e 2e 20 28 54 61 | 62 6c 65 74 20 68 6f 72 |gin. (Ta|blet hor|
|00002070| 69 7a 6f 6e 74 61 6c 20 | 69 73 20 6e 6f 72 6d 61 |izontal |is norma|
|00002080| 6c 6c 79 20 74 68 65 20 | 78 20 63 6f 6f 72 64 69 |lly the |x coordi|
|00002090| 6e 61 74 65 20 61 6e 64 | 20 74 61 62 6c 65 74 20 |nate and| tablet |
|000020a0| 76 65 72 74 69 63 61 6c | 20 74 68 65 20 79 20 63 |vertical| the y c|
|000020b0| 6f 6f 72 64 69 6e 61 74 | 65 2e 20 53 65 65 20 4e |oordinat|e. See N|
|000020c0| 6f 74 65 20 31 20 66 6f | 72 20 61 6e 20 65 78 61 |ote 1 fo|r an exa|
|000020d0| 6d 70 6c 65 20 63 61 6c | 63 75 6c 61 74 69 6f 6e |mple cal|culation|
|000020e0| 2e 29 0d 54 68 65 20 66 | 6f 75 72 74 68 20 6c 6f |.).The f|ourth lo|
|000020f0| 6e 67 77 6f 72 64 20 6f | 66 20 74 68 65 20 63 75 |ngword o|f the cu|
|00002100| 72 73 6f 72 20 62 6c 6f | 63 6b 20 63 6f 6e 74 61 |rsor blo|ck conta|
|00002110| 69 6e 73 20 74 68 65 20 | 70 72 6f 78 69 6d 69 74 |ins the |proximit|
|00002120| 79 20 66 6c 61 67 2c 20 | 63 75 72 73 6f 72 20 75 |y flag, |cursor u|
|00002130| 70 64 61 74 65 20 66 6c | 61 67 2c 20 6d 6f 75 73 |pdate fl|ag, mous|
|00002140| 65 20 65 76 65 6e 74 20 | 66 6c 61 67 2c 20 6e 75 |e event |flag, nu|
|00002150| 6d 62 65 72 20 6f 66 20 | 62 75 74 74 6f 6e 73 2c |mber of |buttons,|
|00002160| 20 6d 6f 75 73 65 2d 64 | 6f 77 6e 20 70 72 65 73 | mouse-d|own pres|
|00002170| 73 75 72 65 20 74 68 72 | 65 73 68 6f 6c 64 2c 20 |sure thr|eshold, |
|00002180| 61 6e 64 20 62 75 74 74 | 6f 6e 20 6d 61 73 6b 2c |and butt|on mask,|
|00002190| 20 61 73 20 69 6c 6c 75 | 73 74 72 61 74 65 64 20 | as illu|strated |
|000021a0| 69 6e 20 46 69 67 75 72 | 65 20 37 2e 0d 46 69 67 |in Figur|e 7..Fig|
|000021b0| 75 72 65 20 37 20 46 6f | 72 6d 61 74 20 6f 66 20 |ure 7 Fo|rmat of |
|000021c0| 43 75 72 73 6f 72 20 42 | 6c 6f 63 6b d5 73 20 46 |Cursor B|lock.s F|
|000021d0| 6f 75 72 74 68 20 4c 6f | 6e 67 77 6f 72 64 20 20 |ourth Lo|ngword |
|000021e0| 0d 54 68 65 20 6d 6f 75 | 73 65 20 65 76 65 6e 74 |.The mou|se event|
|000021f0| 20 62 69 74 20 28 65 2c | 20 62 69 74 20 32 39 29 | bit (e,| bit 29)|
|00002200| 20 69 73 20 73 65 74 20 | 74 6f 20 31 20 62 79 20 | is set |to 1 by |
|00002210| 74 68 65 20 64 72 69 76 | 65 72 20 69 66 20 61 6e |the driv|er if an|
|00002220| 79 20 62 75 74 74 6f 6e | 20 74 68 61 74 20 70 72 |y button| that pr|
|00002230| 6f 76 69 64 65 73 20 61 | 20 6d 6f 75 73 65 20 63 |ovides a| mouse c|
|00002240| 6c 69 63 6b 20 66 75 6e | 63 74 69 6f 6e 20 69 73 |lick fun|ction is|
|00002250| 20 70 72 65 73 73 65 64 | 2e 20 54 68 69 73 20 62 | pressed|. This b|
|00002260| 69 74 20 69 73 20 76 61 | 6c 69 64 20 6f 6e 6c 79 |it is va|lid only|
|00002270| 20 77 68 65 6e 20 74 68 | 65 20 73 20 62 69 74 20 | when th|e s bit |
|00002280| 69 73 20 30 2e 20 41 20 | 31 20 69 6e 64 69 63 61 |is 0. A |1 indica|
|00002290| 74 65 73 20 74 68 61 74 | 20 61 20 6d 6f 75 73 65 |tes that| a mouse|
|000022a0| 20 62 75 74 74 6f 6e 20 | 69 73 20 d2 64 6f 77 6e | button |is .down|
|000022b0| d3 3b 20 61 20 30 20 69 | 6e 64 69 63 61 74 65 73 |.; a 0 i|ndicates|
|000022c0| 20 61 6c 6c 20 6d 6f 75 | 73 65 20 62 75 74 74 6f | all mou|se butto|
|000022d0| 6e 73 20 61 72 65 20 d2 | 75 70 2e d3 20 20 0d 54 |ns are .|up.. .T|
|000022e0| 68 65 20 6d 6f 75 73 65 | 2d 64 6f 77 6e 20 70 72 |he mouse|-down pr|
|000022f0| 65 73 73 75 72 65 20 74 | 68 72 65 73 68 6f 6c 64 |essure t|hreshold|
|00002300| 20 28 62 69 74 73 20 32 | 33 d0 31 36 29 20 61 70 | (bits 2|3.16) ap|
|00002310| 70 6c 69 65 73 20 74 6f | 20 61 20 74 72 61 6e 73 |plies to| a trans|
|00002320| 64 75 63 65 72 20 63 61 | 70 61 62 6c 65 20 6f 66 |ducer ca|pable of|
|00002330| 20 73 65 6e 73 69 6e 67 | 20 70 72 65 73 73 75 72 | sensing| pressur|
|00002340| 65 20 61 74 20 6f 6e 65 | 20 6f 72 20 6d 6f 72 65 |e at one| or more|
|00002350| 20 6f 66 20 69 74 73 20 | 73 77 69 74 63 68 65 73 | of its |switches|
|00002360| 20 28 66 6f 72 20 65 78 | 61 6d 70 6c 65 2c 20 61 | (for ex|ample, a|
|00002370| 20 73 74 79 6c 75 73 20 | 77 69 74 68 20 61 20 70 | stylus |with a p|
|00002380| 72 65 73 73 75 72 65 2d | 73 65 6e 73 69 74 69 76 |ressure-|sensitiv|
|00002390| 65 20 74 69 70 29 2e 20 | 54 68 65 20 6d 6f 75 73 |e tip). |The mous|
|000023a0| 65 2d 64 6f 77 6e 20 70 | 72 65 73 73 75 72 65 20 |e-down p|ressure |
|000023b0| 74 68 72 65 73 68 6f 6c | 64 20 76 61 6c 75 65 20 |threshol|d value |
|000023c0| 69 73 20 73 65 74 20 62 | 79 20 74 68 65 20 75 73 |is set b|y the us|
|000023d0| 65 72 20 28 74 79 70 69 | 63 61 6c 6c 79 20 76 69 |er (typi|cally vi|
|000023e0| 61 20 61 20 43 44 45 56 | 29 2e 20 49 74 20 73 70 |a a CDEV|). It sp|
|000023f0| 65 63 69 66 69 65 73 20 | 74 68 65 20 70 72 65 73 |ecifies |the pres|
|00002400| 73 75 72 65 20 6c 65 76 | 65 6c 20 74 68 61 74 20 |sure lev|el that |
|00002410| 6d 75 73 74 20 62 65 20 | 6d 65 74 20 6f 72 20 65 |must be |met or e|
|00002420| 78 63 65 65 64 65 64 20 | 66 6f 72 20 61 20 6d 6f |xceeded |for a mo|
|00002430| 75 73 65 2d 64 6f 77 6e | 20 74 6f 20 62 65 20 70 |use-down| to be p|
|00002440| 6f 73 74 65 64 20 62 79 | 20 74 68 65 20 64 72 69 |osted by| the dri|
|00002450| 76 65 72 2e 20 57 68 65 | 6e 20 74 68 65 20 70 72 |ver. Whe|n the pr|
|00002460| 65 73 73 75 72 65 20 6c | 65 76 65 6c 20 64 72 6f |essure l|evel dro|
|00002470| 70 73 20 62 65 6c 6f 77 | 20 74 68 65 20 74 68 72 |ps below| the thr|
|00002480| 65 73 68 6f 6c 64 2c 20 | 74 68 65 20 64 72 69 76 |eshold, |the driv|
|00002490| 65 72 20 77 69 6c 6c 20 | 70 6f 73 74 20 61 20 6d |er will |post a m|
|000024a0| 6f 75 73 65 2d 75 70 2e | 20 49 66 20 74 68 65 20 |ouse-up.| If the |
|000024b0| 70 72 65 73 73 75 72 65 | 20 72 65 73 6f 6c 75 74 |pressure| resolut|
|000024c0| 69 6f 6e 20 28 6c 6f 6e | 67 77 6f 72 64 20 31 2c |ion (lon|gword 1,|
|000024d0| 20 6c 6f 77 65 72 20 77 | 6f 72 64 29 20 69 73 20 | lower w|ord) is |
|000024e0| 32 35 36 20 6f 72 20 6c | 65 73 73 2c 20 74 68 65 |256 or l|ess, the|
|000024f0| 20 74 68 72 65 73 68 6f | 6c 64 20 76 61 6c 75 65 | thresho|ld value|
|00002500| 20 63 61 6e 20 62 65 20 | 75 73 65 64 20 77 69 74 | can be |used wit|
|00002510| 68 6f 75 74 20 6d 6f 64 | 69 66 69 63 61 74 69 6f |hout mod|ificatio|
|00002520| 6e 2e 20 49 66 20 74 68 | 65 20 72 65 73 6f 6c 75 |n. If th|e resolu|
|00002530| 74 69 6f 6e 20 65 78 63 | 65 65 64 73 20 32 35 36 |tion exc|eeds 256|
|00002540| 2c 20 74 68 65 20 74 68 | 72 65 73 68 6f 6c 64 20 |, the th|reshold |
|00002550| 73 68 6f 75 6c 64 20 62 | 65 20 73 63 61 6c 65 64 |should b|e scaled|
|00002560| 20 61 73 20 66 6f 6c 6c | 6f 77 73 3a 0d 09 20 20 | as foll|ows:.. |
|00002570| 20 20 73 63 61 6c 65 64 | 20 74 68 72 65 73 68 6f | scaled| thresho|
|00002580| 6c 64 20 3d 20 74 68 72 | 65 73 68 6f 6c 64 20 2a |ld = thr|eshold *|
|00002590| 20 28 70 72 65 73 73 75 | 72 65 20 72 65 73 6f 6c | (pressu|re resol|
|000025a0| 75 74 69 6f 6e 20 2f 20 | 32 35 36 29 0d 54 68 65 |ution / |256).The|
|000025b0| 20 70 72 6f 78 69 6d 69 | 74 79 20 66 6c 61 67 20 | proximi|ty flag |
|000025c0| 28 70 2c 20 62 69 74 20 | 33 31 29 20 69 6e 64 69 |(p, bit |31) indi|
|000025d0| 63 61 74 65 73 20 77 68 | 65 74 68 65 72 20 74 68 |cates wh|ether th|
|000025e0| 65 20 63 75 72 73 6f 72 | 20 69 73 20 77 69 74 68 |e cursor| is with|
|000025f0| 69 6e 20 74 68 65 20 73 | 65 6e 73 65 20 61 72 65 |in the s|ense are|
|00002600| 61 20 28 6f 72 20 77 61 | 73 20 69 6e 20 70 72 6f |a (or wa|s in pro|
|00002610| 78 69 6d 69 74 79 20 74 | 68 65 20 6c 61 73 74 20 |ximity t|he last |
|00002620| 74 69 6d 65 20 74 68 65 | 20 64 61 74 61 20 73 74 |time the| data st|
|00002630| 72 75 63 74 75 72 65 20 | 77 61 73 20 75 70 64 61 |ructure |was upda|
|00002640| 74 65 64 29 2c 20 77 69 | 74 68 20 61 20 6f 6e 65 |ted), wi|th a one|
|00002650| 20 69 6e 64 69 63 61 74 | 69 6e 67 20 74 68 61 74 | indicat|ing that|
|00002660| 20 74 68 65 20 63 75 72 | 73 6f 72 20 69 73 20 69 | the cur|sor is i|
|00002670| 6e 20 70 72 6f 78 69 6d | 69 74 79 2e 20 54 68 65 |n proxim|ity. The|
|00002680| 20 63 75 72 73 6f 72 20 | 75 70 64 61 74 65 20 66 | cursor |update f|
|00002690| 6c 61 67 20 28 73 2c 20 | 62 69 74 20 33 30 29 20 |lag (s, |bit 30) |
|000026a0| 69 73 20 75 73 65 64 20 | 74 6f 20 64 69 73 61 62 |is used |to disab|
|000026b0| 6c 65 20 74 68 65 20 64 | 72 69 76 65 72 20 66 72 |le the d|river fr|
|000026c0| 6f 6d 20 75 70 64 61 74 | 69 6e 67 20 74 68 65 20 |om updat|ing the |
|000026d0| 73 79 73 74 65 6d 20 63 | 75 72 73 6f 72 20 6f 72 |system c|ursor or|
|000026e0| 20 66 72 6f 6d 20 70 6f | 73 74 69 6e 67 20 6d 6f | from po|sting mo|
|000026f0| 75 73 65 2d 75 70 20 61 | 6e 64 20 6d 6f 75 73 65 |use-up a|nd mouse|
|00002700| 2d 64 6f 77 6e 20 65 76 | 65 6e 74 73 3b 20 77 68 |-down ev|ents; wh|
|00002710| 65 6e 20 74 68 69 73 20 | 66 6c 61 67 20 69 73 20 |en this |flag is |
|00002720| 73 65 74 2c 20 74 68 65 | 20 61 70 70 6c 69 63 61 |set, the| applica|
|00002730| 74 69 6f 6e 20 61 73 73 | 75 6d 65 73 20 74 68 69 |tion ass|umes thi|
|00002740| 73 20 72 65 73 70 6f 6e | 73 69 62 69 6c 69 74 79 |s respon|sibility|
|00002750| 2e 20 41 20 66 69 76 65 | 2d 62 69 74 20 66 69 65 |. A five|-bit fie|
|00002760| 6c 64 20 28 6e 75 6d 2c | 20 62 69 74 73 20 32 38 |ld (num,| bits 28|
|00002770| d0 32 34 29 20 73 70 65 | 63 69 66 69 65 73 20 74 |.24) spe|cifies t|
|00002780| 68 65 20 6e 75 6d 62 65 | 72 20 6f 66 20 62 75 74 |he numbe|r of but|
|00002790| 74 6f 6e 73 20 6f 6e 20 | 74 68 65 20 64 65 76 69 |tons on |the devi|
|000027a0| 63 65 3b 20 61 20 76 61 | 6c 75 65 20 6f 66 20 7a |ce; a va|lue of z|
|000027b0| 65 72 6f 20 69 6e 20 74 | 68 69 73 20 66 69 65 6c |ero in t|his fiel|
|000027c0| 64 20 69 6e 64 69 63 61 | 74 65 73 20 74 68 61 74 |d indica|tes that|
|000027d0| 20 74 68 65 20 6e 75 6d | 62 65 72 20 6f 66 20 62 | the num|ber of b|
|000027e0| 75 74 74 6f 6e 73 20 69 | 73 20 75 6e 6b 6e 6f 77 |uttons i|s unknow|
|000027f0| 6e 2e 20 54 68 65 20 62 | 75 74 74 6f 6e 20 6d 61 |n. The b|utton ma|
|00002800| 73 6b 20 28 62 75 74 74 | 6f 6e 20 6d 61 73 6b 2c |sk (butt|on mask,|
|00002810| 20 62 69 74 73 20 31 35 | d0 30 20 63 6f 72 72 65 | bits 15|.0 corre|
|00002820| 73 70 6f 6e 64 69 6e 67 | 20 74 6f 20 62 75 74 74 |sponding| to butt|
|00002830| 6f 6e 73 20 31 35 d0 30 | 29 20 69 6e 64 69 63 61 |ons 15.0|) indica|
|00002840| 74 65 73 20 77 68 69 63 | 68 20 62 75 74 74 6f 6e |tes whic|h button|
|00002850| 73 20 61 72 65 20 75 73 | 65 64 20 62 79 20 74 68 |s are us|ed by th|
|00002860| 65 20 64 72 69 76 65 72 | 20 28 66 6f 72 20 65 78 |e driver| (for ex|
|00002870| 61 6d 70 6c 65 2c 20 66 | 6f 72 20 73 79 73 74 65 |ample, f|or syste|
|00002880| 6d 20 63 75 72 73 6f 72 | 20 63 6f 6e 74 72 6f 6c |m cursor| control|
|00002890| 20 61 6e 64 20 6d 6f 75 | 73 65 2d 75 70 20 61 6e | and mou|se-up an|
|000028a0| 64 20 6d 6f 75 73 65 2d | 64 6f 77 6e 20 65 76 65 |d mouse-|down eve|
|000028b0| 6e 74 73 29 20 61 6e 64 | 20 77 68 69 63 68 20 62 |nts) and| which b|
|000028c0| 75 74 74 6f 6e 73 20 61 | 72 65 20 61 76 61 69 6c |uttons a|re avail|
|000028d0| 61 62 6c 65 20 66 6f 72 | 20 61 70 70 6c 69 63 61 |able for| applica|
|000028e0| 74 69 6f 6e 20 75 73 61 | 67 65 20 77 68 65 6e 20 |tion usa|ge when |
|000028f0| 74 68 65 20 73 20 62 69 | 74 20 69 73 20 7a 65 72 |the s bi|t is zer|
|00002900| 6f 2e 20 41 20 76 61 6c | 75 65 20 6f 66 20 30 20 |o. A val|ue of 0 |
|00002910| 69 6e 64 69 63 61 74 65 | 73 20 74 68 61 74 20 74 |indicate|s that t|
|00002920| 68 65 20 62 75 74 74 6f | 6e 20 69 73 20 62 65 69 |he butto|n is bei|
|00002930| 6e 67 20 75 73 65 64 20 | 62 79 20 74 68 65 20 64 |ng used |by the d|
|00002940| 72 69 76 65 72 3b 20 61 | 20 76 61 6c 75 65 20 6f |river; a| value o|
|00002950| 66 20 31 20 69 6e 64 69 | 63 61 74 65 73 20 74 68 |f 1 indi|cates th|
|00002960| 61 74 20 74 68 65 20 62 | 75 74 74 6f 6e 20 69 73 |at the b|utton is|
|00002970| 20 61 76 61 69 6c 61 62 | 6c 65 20 66 6f 72 20 75 | availab|le for u|
|00002980| 73 65 20 62 79 20 20 61 | 6e 20 61 70 70 6c 69 63 |se by a|n applic|
|00002990| 61 74 69 6f 6e 2e 20 57 | 68 65 6e 20 74 68 65 20 |ation. W|hen the |
|000029a0| 73 20 62 69 74 20 69 73 | 20 31 2c 20 74 68 65 20 |s bit is| 1, the |
|000029b0| 61 63 74 69 76 69 74 79 | 20 6f 66 20 61 6c 6c 20 |activity| of all |
|000029c0| 62 75 74 74 6f 6e 73 20 | 69 73 20 72 65 70 6f 72 |buttons |is repor|
|000029d0| 74 65 64 20 69 6e 20 74 | 68 65 20 62 75 74 74 6f |ted in t|he butto|
|000029e0| 6e 20 75 70 64 61 74 65 | 20 66 69 65 6c 64 2e 20 |n update| field. |
|000029f0| 57 68 65 6e 20 74 68 65 | 20 73 20 62 69 74 20 69 |When the| s bit i|
|00002a00| 73 20 30 2c 20 6f 6e 6c | 79 20 74 68 65 20 61 63 |s 0, onl|y the ac|
|00002a10| 74 69 76 69 74 79 20 6f | 66 20 62 75 74 74 6f 6e |tivity o|f button|
|00002a20| 73 20 6d 61 72 6b 65 64 | 20 61 73 20 61 76 61 69 |s marked| as avai|
|00002a30| 6c 61 62 6c 65 20 28 76 | 61 6c 75 65 20 6f 66 20 |lable (v|alue of |
|00002a40| 31 29 20 69 6e 20 74 68 | 65 20 62 75 74 74 6f 6e |1) in th|e button|
|00002a50| 20 6d 61 73 6b 20 69 73 | 20 72 65 70 6f 72 74 65 | mask is| reporte|
|00002a60| 64 2e 20 54 68 65 20 62 | 75 74 74 6f 6e 20 6d 61 |d. The b|utton ma|
|00002a70| 73 6b 20 66 69 65 6c 64 | 20 69 73 20 69 6e 74 65 |sk field| is inte|
|00002a80| 6e 64 65 64 20 70 72 69 | 6d 61 72 69 6c 79 20 74 |nded pri|marily t|
|00002a90| 6f 20 62 65 20 72 65 61 | 64 20 62 79 20 61 6e 20 |o be rea|d by an |
|00002aa0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 2e 20 41 6e 20 |applicat|ion. An |
|00002ab0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 6d 61 79 20 |applicat|ion may |
|00002ac0| 61 6c 74 65 72 20 69 74 | 2c 20 62 75 74 20 73 68 |alter it|, but sh|
|00002ad0| 6f 75 6c 64 20 72 65 73 | 74 6f 72 65 20 69 74 20 |ould res|tore it |
|00002ae0| 75 70 6f 6e 20 74 65 72 | 6d 69 6e 61 74 69 6f 6e |upon ter|mination|
|00002af0| 2e 20 53 65 65 20 4e 6f | 74 65 20 32 20 66 6f 72 |. See No|te 2 for|
|00002b00| 20 6d 6f 72 65 20 64 65 | 74 61 69 6c 73 2e 0d 54 | more de|tails..T|
|00002b10| 68 65 20 66 69 66 74 68 | 20 6c 6f 6e 67 77 6f 72 |he fifth| longwor|
|00002b20| 64 20 6f 66 20 74 68 65 | 20 63 75 72 73 6f 72 20 |d of the| cursor |
|00002b30| 62 6c 6f 63 6b 20 63 6f | 6e 74 61 69 6e 73 20 74 |block co|ntains t|
|00002b40| 68 65 20 62 75 74 74 6f | 6e 20 75 70 64 61 74 65 |he butto|n update|
|00002b50| 2e 20 54 68 65 20 66 6f | 72 6d 61 74 20 6f 66 20 |. The fo|rmat of |
|00002b60| 74 68 69 73 20 6c 6f 6e | 67 77 6f 72 64 20 20 20 |this lon|gword |
|00002b70| 69 73 20 69 6c 6c 75 73 | 74 72 61 74 65 64 20 69 |is illus|trated i|
|00002b80| 6e 20 46 69 67 75 72 65 | 20 38 2e 20 0d 46 69 67 |n Figure| 8. .Fig|
|00002b90| 75 72 65 20 38 20 46 6f | 72 6d 61 74 20 6f 66 20 |ure 8 Fo|rmat of |
|00002ba0| 43 75 72 73 6f 72 20 42 | 6c 6f 63 6b d5 73 20 46 |Cursor B|lock.s F|
|00002bb0| 69 66 74 68 20 4c 6f 6e | 67 77 6f 72 64 20 20 0d |ifth Lon|gword .|
|00002bc0| 41 6e 20 65 69 67 68 74 | 2d 62 69 74 20 66 69 65 |An eight|-bit fie|
|00002bd0| 6c 64 20 28 65 72 72 6f | 72 2c 20 62 69 74 73 20 |ld (erro|r, bits |
|00002be0| 33 31 d0 31 36 29 20 63 | 61 6e 20 62 65 20 75 73 |31.16) c|an be us|
|00002bf0| 65 64 20 66 6f 72 20 61 | 6e 20 65 72 72 6f 72 20 |ed for a|n error |
|00002c00| 63 6f 64 65 20 72 65 74 | 75 72 6e 3b 20 61 20 7a |code ret|urn; a z|
|00002c10| 65 72 6f 20 69 6e 20 74 | 68 69 73 20 66 69 65 6c |ero in t|his fiel|
|00002c20| 64 20 69 6e 64 69 63 61 | 74 65 73 20 6e 6f 20 65 |d indica|tes no e|
|00002c30| 72 72 6f 72 20 28 6f 72 | 20 6e 6f 20 65 72 72 6f |rror (or| no erro|
|00002c40| 72 20 63 6f 64 65 20 69 | 73 20 72 65 74 75 72 6e |r code i|s return|
|00002c50| 65 64 29 2e 20 41 20 31 | 36 2d 62 69 74 20 66 69 |ed). A 1|6-bit fi|
|00002c60| 65 6c 64 20 28 62 75 74 | 74 6f 6e 20 75 70 64 61 |eld (but|ton upda|
|00002c70| 74 65 2c 20 62 69 74 73 | 20 31 35 d0 30 20 63 6f |te, bits| 15.0 co|
|00002c80| 72 72 65 73 70 6f 6e 64 | 69 6e 67 20 74 6f 20 62 |rrespond|ing to b|
|00002c90| 75 74 74 6f 6e 73 20 31 | 35 d0 30 29 20 65 6e 63 |uttons 1|5.0) enc|
|00002ca0| 6f 64 65 73 20 74 68 65 | 20 61 63 74 69 76 65 20 |odes the| active |
|00002cb0| 73 77 69 74 63 68 20 6f | 72 20 73 77 69 74 63 68 |switch o|r switch|
|00002cc0| 65 73 2c 20 6f 6e 65 20 | 73 77 69 74 63 68 20 70 |es, one |switch p|
|00002cd0| 65 72 20 62 69 74 2c 20 | 77 69 74 68 20 61 20 6f |er bit, |with a o|
|00002ce0| 6e 65 20 69 6e 20 74 68 | 65 20 62 69 74 20 70 6f |ne in th|e bit po|
|00002cf0| 73 69 74 69 6f 6e 20 69 | 6e 64 69 63 61 74 69 6e |sition i|ndicatin|
|00002d00| 67 20 74 68 61 74 20 74 | 68 65 20 62 75 74 74 6f |g that t|he butto|
|00002d10| 6e 20 69 73 20 61 63 74 | 69 76 65 2e 20 42 79 20 |n is act|ive. By |
|00002d20| 63 6f 6e 76 65 6e 74 69 | 6f 6e 2c 20 66 6f 72 20 |conventi|on, for |
|00002d30| 61 20 73 74 79 6c 75 73 | 2c 20 62 69 74 20 7a 65 |a stylus|, bit ze|
|00002d40| 72 6f 20 69 73 20 69 64 | 65 6e 74 69 66 69 65 64 |ro is id|entified|
|00002d50| 20 77 69 74 68 20 74 68 | 65 20 74 69 70 2e 0d 54 | with th|e tip..T|
|00002d60| 68 65 20 73 69 78 74 68 | 20 6c 6f 6e 67 77 6f 72 |he sixth| longwor|
|00002d70| 64 20 6f 66 20 74 68 65 | 20 63 75 72 73 6f 72 20 |d of the| cursor |
|00002d80| 62 6c 6f 63 6b 20 63 6f | 6e 74 61 69 6e 73 20 74 |block co|ntains t|
|00002d90| 68 65 20 70 72 65 73 73 | 75 72 65 2e 20 54 77 6f |he press|ure. Two|
|00002da0| 20 31 36 2d 62 69 74 20 | 75 6e 73 69 67 6e 65 64 | 16-bit |unsigned|
|00002db0| 20 6e 75 6d 62 65 72 73 | 20 28 72 69 67 68 74 20 | numbers| (right |
|00002dc0| 6a 75 73 74 69 66 69 65 | 64 29 20 69 6e 64 69 63 |justifie|d) indic|
|00002dd0| 61 74 65 20 64 65 74 65 | 63 74 65 64 20 70 72 65 |ate dete|cted pre|
|00002de0| 73 73 75 72 65 20 69 6e | 20 6e 6f 72 6d 61 6c 20 |ssure in| normal |
|00002df0| 61 6e 64 20 74 61 6e 67 | 65 6e 74 69 61 6c 20 64 |and tang|ential d|
|00002e00| 69 72 65 63 74 69 6f 6e | 73 2e 20 46 69 67 75 72 |irection|s. Figur|
|00002e10| 65 20 39 20 69 6c 6c 75 | 73 74 72 61 74 65 73 20 |e 9 illu|strates |
|00002e20| 74 68 65 20 66 6f 72 6d | 61 74 20 6f 66 20 74 68 |the form|at of th|
|00002e30| 69 73 20 6c 6f 6e 67 77 | 6f 72 64 2e 0d 46 69 67 |is longw|ord..Fig|
|00002e40| 75 72 65 20 39 20 46 6f | 72 6d 61 74 20 6f 66 20 |ure 9 Fo|rmat of |
|00002e50| 43 75 72 73 6f 72 20 42 | 6c 6f 63 6b d5 73 20 53 |Cursor B|lock.s S|
|00002e60| 69 78 74 68 20 4c 6f 6e | 67 77 6f 72 64 20 20 0d |ixth Lon|gword .|
|00002e70| 54 68 65 20 73 65 76 65 | 6e 74 68 20 6c 6f 6e 67 |The seve|nth long|
|00002e80| 77 6f 72 64 20 6f 66 20 | 74 68 65 20 63 75 72 73 |word of |the curs|
|00002e90| 6f 72 20 62 6c 6f 63 6b | 20 63 6f 6e 74 61 69 6e |or block| contain|
|00002ea0| 73 20 74 68 65 20 74 69 | 6d 65 20 73 74 61 6d 70 |s the ti|me stamp|
|00002eb0| 2e 20 45 61 63 68 20 74 | 69 6d 65 20 74 68 69 73 |. Each t|ime this|
|00002ec0| 20 62 6c 6f 63 6b 20 6f | 66 20 69 6e 66 6f 72 6d | block o|f inform|
|00002ed0| 61 74 69 6f 6e 20 69 73 | 20 75 70 64 61 74 65 64 |ation is| updated|
|00002ee0| 2c 20 74 68 69 73 20 66 | 69 65 6c 64 20 72 65 63 |, this f|ield rec|
|00002ef0| 6f 72 64 73 20 74 68 65 | 20 6e 75 6d 62 65 72 20 |ords the| number |
|00002f00| 6f 66 20 74 69 63 6b 73 | 20 73 69 6e 63 65 20 73 |of ticks| since s|
|00002f10| 79 73 74 65 6d 20 73 74 | 61 72 74 75 70 2e 0d 54 |ystem st|artup..T|
|00002f20| 68 65 20 65 69 67 68 74 | 68 2c 20 6e 69 6e 74 68 |he eight|h, ninth|
|00002f30| 2c 20 61 6e 64 20 74 65 | 6e 74 68 20 6c 6f 6e 67 |, and te|nth long|
|00002f40| 77 6f 72 64 73 20 6f 66 | 20 74 68 65 20 63 75 72 |words of| the cur|
|00002f50| 73 6f 72 20 62 6c 6f 63 | 6b 20 63 6f 6e 74 61 69 |sor bloc|k contai|
|00002f60| 6e 20 74 68 65 20 58 2c | 20 59 2c 20 61 6e 64 20 |n the X,| Y, and |
|00002f70| 5a 20 63 6f 6f 72 64 69 | 6e 61 74 65 73 20 72 65 |Z coordi|nates re|
|00002f80| 73 70 65 63 74 69 76 65 | 6c 79 2e 0d 54 68 65 20 |spective|ly..The |
|00002f90| 65 6c 65 76 65 6e 74 68 | 20 74 68 72 6f 75 67 68 |eleventh| through|
|00002fa0| 20 66 69 66 74 65 65 6e | 74 68 20 6c 6f 6e 67 77 | fifteen|th longw|
|00002fb0| 6f 72 64 73 20 63 6f 6e | 74 61 69 6e 20 6f 72 69 |ords con|tain ori|
|00002fc0| 65 6e 74 61 74 69 6f 6e | 20 69 6e 66 6f 72 6d 61 |entation| informa|
|00002fd0| 74 69 6f 6e 2e 20 46 6f | 72 20 61 6e 20 61 74 74 |tion. Fo|r an att|
|00002fe0| 69 74 75 64 65 20 6d 61 | 74 72 69 78 2c 20 65 61 |itude ma|trix, ea|
|00002ff0| 63 68 20 6c 6f 6e 67 77 | 6f 72 64 20 63 6f 6e 74 |ch longw|ord cont|
|00003000| 61 69 6e 73 20 74 77 6f | 20 31 36 2d 62 69 74 20 |ains two| 16-bit |
|00003010| 66 69 65 6c 64 73 3b 20 | 6e 69 6e 65 20 65 6c 65 |fields; |nine ele|
|00003020| 6d 65 6e 74 73 20 63 61 | 6e 20 62 65 20 75 73 65 |ments ca|n be use|
|00003030| 64 20 74 6f 20 63 6f 6e | 73 74 72 75 63 74 20 74 |d to con|struct t|
|00003040| 68 65 20 61 74 74 69 74 | 75 64 65 20 6d 61 74 72 |he attit|ude matr|
|00003050| 69 78 2e 20 41 31 31 20 | 61 6e 64 20 41 31 32 20 |ix. A11 |and A12 |
|00003060| 61 72 65 20 69 6e 20 74 | 68 65 20 66 69 72 73 74 |are in t|he first|
|00003070| 20 6c 6f 6e 67 77 6f 72 | 64 2c 20 41 31 33 20 61 | longwor|d, A13 a|
|00003080| 6e 64 20 41 32 31 20 61 | 72 65 20 69 6e 20 74 68 |nd A21 a|re in th|
|00003090| 65 20 73 65 63 6f 6e 64 | 2c 20 41 32 32 20 61 6e |e second|, A22 an|
|000030a0| 64 20 41 32 33 20 61 72 | 65 20 69 6e 20 74 68 65 |d A23 ar|e in the|
|000030b0| 20 74 68 69 72 64 2c 20 | 41 33 31 20 61 6e 64 20 | third, |A31 and |
|000030c0| 41 33 32 20 61 72 65 20 | 69 6e 20 74 68 65 20 66 |A32 are |in the f|
|000030d0| 6f 75 72 74 68 2c 20 61 | 6e 64 20 41 33 33 20 69 |ourth, a|nd A33 i|
|000030e0| 73 20 69 6e 20 74 68 65 | 20 66 69 66 74 68 2c 20 |s in the| fifth, |
|000030f0| 61 73 20 69 6c 6c 75 73 | 74 72 61 74 65 64 20 69 |as illus|trated i|
|00003100| 6e 20 46 69 67 75 72 65 | 20 31 30 2e 0d 46 69 67 |n Figure| 10..Fig|
|00003110| 75 72 65 20 31 30 20 41 | 74 74 69 74 75 64 65 20 |ure 10 A|ttitude |
|00003120| 4d 61 74 72 69 78 0d 46 | 6f 72 20 70 65 6e 20 74 |Matrix.F|or pen t|
|00003130| 69 6c 74 2c 20 74 68 65 | 20 78 2d 74 69 6c 74 20 |ilt, the| x-tilt |
|00003140| 69 73 20 69 6e 20 74 68 | 65 20 75 70 70 65 72 20 |is in th|e upper |
|00003150| 31 36 20 62 69 74 73 20 | 6f 66 20 6c 6f 6e 67 77 |16 bits |of longw|
|00003160| 6f 72 64 20 6e 69 6e 65 | 2c 20 77 68 69 6c 65 20 |ord nine|, while |
|00003170| 74 68 65 20 79 2d 74 69 | 6c 74 20 69 73 20 69 6e |the y-ti|lt is in|
|00003180| 20 74 68 65 20 6c 6f 77 | 65 72 20 31 36 20 62 69 | the low|er 16 bi|
|00003190| 74 73 3b 20 74 68 65 20 | 6f 74 68 65 72 20 66 6f |ts; the |other fo|
|000031a0| 75 72 20 6c 6f 6e 67 77 | 6f 72 64 73 20 61 72 65 |ur longw|ords are|
|000031b0| 20 75 6e 75 73 65 64 20 | 61 73 20 69 6c 6c 75 73 | unused |as illus|
|000031c0| 74 72 61 74 65 64 20 69 | 6e 20 46 69 67 75 72 65 |trated i|n Figure|
|000031d0| 20 31 31 2e 0d 46 69 67 | 75 72 65 20 31 31 20 58 | 11..Fig|ure 11 X|
|000031e0| 2d 54 69 6c 74 20 61 6e | 64 20 59 2d 54 69 6c 74 |-Tilt an|d Y-Tilt|
|000031f0| 0d 54 68 65 20 74 69 6c | 74 20 76 61 6c 75 65 73 |.The til|t values|
|00003200| 20 61 72 65 20 73 69 67 | 6e 65 64 20 6e 75 6d 62 | are sig|ned numb|
|00003210| 65 72 73 2e 20 54 68 65 | 20 74 69 6c 74 20 76 61 |ers. The| tilt va|
|00003220| 6c 75 65 73 20 72 61 6e | 67 65 20 66 72 6f 6d 20 |lues ran|ge from |
|00003230| d0 28 61 6e 67 75 6c 61 | 72 20 72 65 73 6f 6c 75 |.(angula|r resolu|
|00003240| 74 69 6f 6e 20 2f 20 32 | 29 20 74 6f 20 2b 28 61 |tion / 2|) to +(a|
|00003250| 6e 67 75 6c 61 72 20 72 | 65 73 6f 6c 75 74 69 6f |ngular r|esolutio|
|00003260| 6e 20 2f 20 32 29 2e 20 | 57 68 65 6e 20 74 68 65 |n / 2). |When the|
|00003270| 20 70 65 6e 20 69 73 20 | 70 65 72 70 65 6e 64 69 | pen is |perpendi|
|00003280| 63 75 6c 61 72 20 74 6f | 20 74 68 65 20 74 61 62 |cular to| the tab|
|00003290| 6c 65 74 20 69 6e 20 62 | 6f 74 68 20 74 68 65 20 |let in b|oth the |
|000032a0| 78 20 61 6e 64 20 79 20 | 63 6f 6f 72 64 69 6e 61 |x and y |coordina|
|000032b0| 74 65 73 2c 20 74 68 65 | 20 78 20 61 6e 64 20 79 |tes, the| x and y|
|000032c0| 20 74 69 6c 74 20 76 61 | 6c 75 65 73 20 61 72 65 | tilt va|lues are|
|000032d0| 20 30 2e 0d 4e 6f 74 65 | 73 0d 31 2e 09 54 68 65 | 0..Note|s.1..The|
|000032e0| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 69 73 20 61 6e | followi|ng is an|
|000032f0| 20 65 78 61 6d 70 6c 65 | 20 6f 66 20 6d 61 70 70 | example| of mapp|
|00003300| 69 6e 67 20 62 65 74 77 | 65 65 6e 20 61 20 73 63 |ing betw|een a sc|
|00003310| 72 65 65 6e 20 77 69 6e | 64 6f 77 20 61 6e 64 20 |reen win|dow and |
|00003320| 74 68 65 20 74 61 62 6c | 65 74 3a 0d 41 73 73 75 |the tabl|et:.Assu|
|00003330| 6d 65 20 74 68 61 74 20 | 61 6e 20 61 72 65 61 20 |me that |an area |
|00003340| 6f 6e 20 74 68 65 20 74 | 61 62 6c 65 74 20 77 69 |on the t|ablet wi|
|00003350| 74 68 20 61 62 73 6f 6c | 75 74 65 20 63 6f 6f 72 |th absol|ute coor|
|00003360| 64 69 6e 61 74 65 73 20 | 28 30 2c 30 29 2c 20 28 |dinates |(0,0), (|
|00003370| 30 2c 31 30 30 30 30 29 | 2c 20 28 31 30 30 30 30 |0,10000)|, (10000|
|00003380| 2c 31 30 30 30 30 29 2c | 20 28 31 30 30 30 30 2c |,10000),| (10000,|
|00003390| 30 29 20 69 73 20 74 6f | 20 62 65 20 6d 61 70 70 |0) is to| be mapp|
|000033a0| 65 64 20 6f 6e 74 6f 20 | 61 20 73 63 72 65 65 6e |ed onto |a screen|
|000033b0| 20 77 69 6e 64 6f 77 20 | 77 69 74 68 20 63 6f 72 | window |with cor|
|000033c0| 72 65 73 70 6f 6e 64 69 | 6e 67 20 73 63 72 65 65 |respondi|ng scree|
|000033d0| 6e 20 63 6f 6f 72 64 69 | 6e 61 74 65 73 20 28 30 |n coordi|nates (0|
|000033e0| 2c 37 32 30 29 2c 20 28 | 30 2c 30 29 2c 20 28 37 |,720), (|0,0), (7|
|000033f0| 32 30 2c 30 29 2c 20 28 | 37 32 30 2c 37 32 30 29 |20,0), (|720,720)|
|00003400| 3b 20 74 68 61 74 20 69 | 73 2c 20 74 68 65 20 74 |; that i|s, the t|
|00003410| 61 62 6c 65 74 d5 73 20 | 6f 72 69 67 69 6e 20 69 |ablet.s |origin i|
|00003420| 73 20 69 6e 20 74 68 65 | 20 62 6f 74 74 6f 6d 20 |s in the| bottom |
|00003430| 6c 65 66 74 20 63 6f 72 | 6e 65 72 20 77 68 69 6c |left cor|ner whil|
|00003440| 65 20 74 68 65 20 77 69 | 6e 64 6f 77 d5 73 20 69 |e the wi|ndow.s i|
|00003450| 73 20 69 6e 20 74 68 65 | 20 74 6f 70 20 6c 65 66 |s in the| top lef|
|00003460| 74 2c 20 61 6e 64 20 74 | 68 65 20 74 61 62 6c 65 |t, and t|he table|
|00003470| 74 20 69 73 20 31 30 2c | 30 30 30 20 75 6e 69 74 |t is 10,|000 unit|
|00003480| 20 73 71 75 61 72 65 20 | 77 68 69 6c 65 20 74 68 | square |while th|
|00003490| 65 20 77 69 6e 64 6f 77 | 20 69 73 20 37 32 30 20 |e window| is 720 |
|000034a0| 75 6e 69 74 20 73 71 75 | 61 72 65 2e 20 54 68 65 |unit squ|are. The|
|000034b0| 20 78 20 73 63 61 6c 65 | 20 69 73 20 37 32 30 2f | x scale| is 720/|
|000034c0| 31 30 30 30 30 3d 30 2e | 30 37 32 2c 20 61 73 20 |10000=0.|072, as |
|000034d0| 69 73 20 74 68 65 20 79 | 20 73 63 61 6c 65 2e 20 |is the y| scale. |
|000034e0| 54 68 65 20 76 61 6c 75 | 65 20 77 6f 75 6c 64 20 |The valu|e would |
|000034f0| 61 63 74 75 61 6c 6c 79 | 20 62 65 20 63 61 6c 63 |actually| be calc|
|00003500| 75 6c 61 74 65 64 20 75 | 73 69 6e 67 20 61 20 33 |ulated u|sing a 3|
|00003510| 32 20 62 79 20 31 36 20 | 64 69 76 69 64 65 2c 20 |2 by 16 |divide, |
|00003520| 77 69 74 68 20 74 68 65 | 20 6e 75 6d 65 72 61 74 |with the| numerat|
|00003530| 6f 72 20 28 37 32 30 29 | 20 69 6e 20 74 68 65 20 |or (720)| in the |
|00003540| 75 70 70 65 72 20 31 36 | 20 62 69 74 73 20 6f 66 |upper 16| bits of|
|00003550| 20 74 68 65 20 33 32 2d | 62 69 74 20 6e 75 6d 65 | the 32-|bit nume|
|00003560| 72 61 74 6f 72 20 28 61 | 6e 64 20 30 20 69 6e 20 |rator (a|nd 0 in |
|00003570| 74 68 65 20 6c 6f 77 65 | 72 20 31 36 20 62 69 74 |the lowe|r 16 bit|
|00003580| 73 29 3b 20 74 68 65 20 | 72 65 73 75 6c 74 20 69 |s); the |result i|
|00003590| 73 20 74 68 65 20 d2 66 | 72 61 63 74 69 6f 6e 61 |s the .f|ractiona|
|000035a0| 6c d3 20 70 61 72 74 20 | 6f 66 20 74 68 65 20 64 |l. part |of the d|
|000035b0| 69 76 69 73 69 6f 6e 20 | 74 6f 20 62 65 20 73 74 |ivision |to be st|
|000035c0| 6f 72 65 64 20 69 6e 20 | 74 68 65 20 73 63 61 6c |ored in |the scal|
|000035d0| 65 20 66 69 65 6c 64 20 | 69 6e 20 74 68 65 20 6d |e field |in the m|
|000035e0| 65 6d 6f 72 79 20 73 74 | 72 75 63 74 75 72 65 2e |emory st|ructure.|
|000035f0| 20 54 68 65 20 78 20 74 | 72 61 6e 73 6c 61 74 69 | The x t|ranslati|
|00003600| 6f 6e 20 69 73 20 30 20 | 61 6e 64 20 74 68 65 20 |on is 0 |and the |
|00003610| 79 20 74 72 61 6e 73 6c | 61 74 69 6f 6e 20 69 73 |y transl|ation is|
|00003620| 20 37 32 30 2e 20 54 68 | 65 73 65 20 66 69 67 75 | 720. Th|ese figu|
|00003630| 72 65 73 20 63 61 6e 20 | 62 65 20 64 65 74 65 72 |res can |be deter|
|00003640| 6d 69 6e 65 64 20 62 79 | 20 74 61 6b 69 6e 67 20 |mined by| taking |
|00003650| 74 68 65 20 6b 6e 6f 77 | 6e 20 63 6f 6f 72 64 69 |the know|n coordi|
|00003660| 6e 61 74 65 73 20 66 6f | 72 20 61 20 73 69 6e 67 |nates fo|r a sing|
|00003670| 6c 65 20 70 6f 69 6e 74 | 20 69 6e 20 62 6f 74 68 |le point| in both|
|00003680| 20 66 72 61 6d 65 73 20 | 61 6e 64 20 73 6f 6c 76 | frames |and solv|
|00003690| 69 6e 67 20 65 61 63 68 | 20 65 71 75 61 74 69 6f |ing each| equatio|
|000036a0| 6e 20 66 6f 72 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |n for th|e follow|
|000036b0| 69 6e 67 20 74 72 61 6e | 73 6c 61 74 69 6f 6e 2c |ing tran|slation,|
|000036c0| 20 75 73 69 6e 67 20 74 | 68 65 20 63 6f 6f 72 64 | using t|he coord|
|000036d0| 69 6e 61 74 65 73 20 66 | 6f 72 20 74 68 65 20 74 |inates f|or the t|
|000036e0| 61 62 6c 65 74 d5 73 20 | 61 62 73 6f 6c 75 74 65 |ablet.s |absolute|
|000036f0| 20 6f 72 69 67 69 6e 3a | 0d 09 20 20 20 20 20 20 | origin:|.. |
|00003700| 20 20 30 20 3d 20 6d 6f | 75 73 65 20 78 20 3d 20 | 0 = mo|use x = |
|00003710| 28 30 29 2a 28 2e 30 37 | 32 29 20 2b 20 78 20 74 |(0)*(.07|2) + x t|
|00003720| 72 61 6e 73 6c 61 74 69 | 6f 6e 20 3d 20 30 0d 09 |ranslati|on = 0..|
|00003730| 20 20 20 20 20 20 20 20 | 37 32 30 20 3d 20 6d 6f | |720 = mo|
|00003740| 75 73 65 20 79 20 3d 20 | 2d 28 31 30 30 30 30 29 |use y = |-(10000)|
|00003750| 2a 28 2e 30 37 32 29 20 | 2b 20 79 20 74 72 61 6e |*(.072) |+ y tran|
|00003760| 73 6c 61 74 69 6f 6e 20 | 3d 20 30 0d 4e 6f 77 20 |slation |= 0.Now |
|00003770| 74 68 65 20 74 61 62 6c | 65 74 20 63 6f 6f 72 64 |the tabl|et coord|
|00003780| 69 6e 61 74 65 20 28 31 | 30 39 38 2c 20 32 35 33 |inate (1|098, 253|
|00003790| 29 20 69 73 20 6d 61 70 | 70 65 64 20 69 6e 74 6f |) is map|ped into|
|000037a0| 20 74 68 65 20 77 69 6e | 64 6f 77 20 63 6f 6f 72 | the win|dow coor|
|000037b0| 64 69 6e 61 74 65 20 73 | 79 73 74 65 6d 20 28 37 |dinate s|ystem (7|
|000037c0| 39 2c 37 30 32 29 3a 0d | 09 20 20 20 20 20 20 20 |9,702):.|. |
|000037d0| 20 6d 6f 75 73 65 20 78 | 20 3d 20 28 31 30 39 38 | mouse x| = (1098|
|000037e0| 29 2a 28 2e 30 37 32 29 | 20 2b 20 30 20 3d 20 37 |)*(.072)| + 0 = 7|
|000037f0| 39 0d 09 20 20 20 20 20 | 20 20 20 6d 6f 75 73 65 |9.. | mouse|
|00003800| 20 79 20 3d 20 2d 28 32 | 35 33 29 2a 28 2e 30 37 | y = -(2|53)*(.07|
|00003810| 32 29 20 2b 20 37 32 30 | 20 3d 20 37 30 32 0d 32 |2) + 720| = 702.2|
|00003820| 2e 20 09 41 6e 20 61 70 | 70 6c 69 63 61 74 69 6f |. .An ap|plicatio|
|00003830| 6e 2c 20 43 6f 6e 74 72 | 6f 6c 20 50 61 6e 65 6c |n, Contr|ol Panel|
|00003840| 20 64 65 76 69 63 65 2c | 20 6f 72 20 6f 74 68 65 | device,| or othe|
|00003850| 72 20 28 6e 6f 6e 2d 64 | 72 69 76 65 72 29 20 65 |r (non-d|river) e|
|00003860| 6e 74 69 74 79 20 6d 61 | 79 20 6d 6f 64 69 66 79 |ntity ma|y modify|
|00003870| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 66 | the fol|lowing f|
|00003880| 69 65 6c 64 73 3a 0d 48 | 65 61 64 65 72 2c 20 77 |ields:.H|eader, w|
|00003890| 6f 72 64 20 31 3a 20 20 | 73 65 6d 61 70 68 6f 72 |ord 1: |semaphor|
|000038a0| 65 2c 20 61 70 70 20 61 | 6e 64 20 64 65 76 20 66 |e, app a|nd dev f|
|000038b0| 6c 61 67 73 3b 0d 43 75 | 72 73 6f 72 20 42 6c 6f |lags;.Cu|rsor Blo|
|000038c0| 63 6b 2c 20 77 6f 72 64 | 73 20 32 2c 33 3a 20 73 |ck, word|s 2,3: s|
|000038d0| 63 61 6c 69 6e 67 20 61 | 6e 64 20 74 72 61 6e 73 |caling a|nd trans|
|000038e0| 6c 61 74 69 6f 6e 2c 20 | 61 6e 64 20 77 6f 72 64 |lation, |and word|
|000038f0| 20 34 3a 20 73 20 62 69 | 74 2c 20 6d 6f 75 73 65 | 4: s bi|t, mouse|
|00003900| 2d 64 6f 77 6e 20 70 72 | 65 73 73 75 72 65 20 74 |-down pr|essure t|
|00003910| 68 72 65 73 68 6f 6c 64 | 20 28 6f 6e 6c 79 20 69 |hreshold| (only i|
|00003920| 66 20 64 65 65 6d 65 64 | 20 6e 65 63 65 73 73 61 |f deemed| necessa|
|00003930| 72 79 29 2c 20 61 6e 64 | 20 62 75 74 74 6f 6e 20 |ry), and| button |
|00003940| 6d 61 73 6b 2e 0d 49 6e | 20 70 61 72 74 69 63 75 |mask..In| particu|
|00003950| 6c 61 72 2c 20 74 68 65 | 20 45 6e 67 6c 69 73 68 |lar, the| English|
|00003960| 20 6f 72 20 6d 65 74 72 | 69 63 20 66 6c 61 67 20 | or metr|ic flag |
|00003970| 69 6e 20 48 65 61 64 65 | 72 20 77 6f 72 64 20 32 |in Heade|r word 2|
|00003980| 20 69 73 20 65 73 74 61 | 62 6c 69 73 68 65 64 20 | is esta|blished |
|00003990| 62 79 20 74 68 65 20 64 | 72 69 76 65 72 20 61 6e |by the d|river an|
|000039a0| 64 20 63 61 6e 6e 6f 74 | 20 62 65 20 63 68 61 6e |d cannot| be chan|
|000039b0| 67 65 64 20 62 79 20 61 | 6e 20 61 70 70 6c 69 63 |ged by a|n applic|
|000039c0| 61 74 69 6f 6e 2c 20 43 | 6f 6e 74 72 6f 6c 20 50 |ation, C|ontrol P|
|000039d0| 61 6e 65 6c 20 64 65 76 | 69 63 65 2c 20 6f 72 20 |anel dev|ice, or |
|000039e0| 6f 74 68 65 72 20 6e 6f | 6e 2d 64 72 69 76 65 72 |other no|n-driver|
|000039f0| 20 65 6e 74 69 74 79 2e | 0d 53 65 74 74 69 6e 67 | entity.|.Setting|
|00003a00| 20 74 68 65 20 73 20 62 | 69 74 20 74 6f 20 31 20 | the s b|it to 1 |
|00003a10| 61 6c 6c 6f 77 73 20 74 | 68 65 20 61 70 70 6c 69 |allows t|he appli|
|00003a20| 63 61 74 69 6f 6e 20 74 | 6f 20 76 69 65 77 20 74 |cation t|o view t|
|00003a30| 68 65 20 73 74 61 74 65 | 20 6f 66 20 61 6c 6c 20 |he state| of all |
|00003a40| 62 75 74 74 6f 6e 73 20 | 76 69 61 20 74 68 65 20 |buttons |via the |
|00003a50| 62 75 74 74 6f 6e 20 75 | 70 64 61 74 65 20 66 69 |button u|pdate fi|
|00003a60| 65 6c 64 2e 20 49 74 20 | 69 6e 68 69 62 69 74 73 |eld. It |inhibits|
|00003a70| 20 74 68 65 20 64 72 69 | 76 65 72 2c 20 68 6f 77 | the dri|ver, how|
|00003a80| 65 76 65 72 2c 20 66 72 | 6f 6d 20 70 65 72 66 6f |ever, fr|om perfo|
|00003a90| 72 6d 69 6e 67 20 61 6e | 79 20 75 73 65 72 20 64 |rming an|y user d|
|00003aa0| 65 66 69 6e 65 64 20 66 | 75 6e 63 74 69 6f 6e 73 |efined f|unctions|
|00003ab0| 20 61 73 73 6f 63 69 61 | 74 65 64 20 77 69 74 68 | associa|ted with|
|00003ac0| 20 74 68 65 20 62 75 74 | 74 6f 6e 73 2e 20 49 66 | the but|tons. If|
|00003ad0| 20 61 6e 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 | an appl|ication |
|00003ae0| 77 69 73 68 65 73 20 74 | 6f 20 75 73 65 20 73 6f |wishes t|o use so|
|00003af0| 6d 65 20 6f 66 20 74 68 | 65 20 62 75 74 74 6f 6e |me of th|e button|
|00003b00| 73 2c 20 62 75 74 20 6c | 65 61 76 65 20 73 6f 6d |s, but l|eave som|
|00003b10| 65 20 61 76 61 69 6c 61 | 62 6c 65 20 66 6f 72 20 |e availa|ble for |
|00003b20| 75 73 65 72 20 66 75 6e | 63 74 69 6f 6e 73 2c 20 |user fun|ctions, |
|00003b30| 69 74 20 63 61 6e 20 63 | 68 61 6e 67 65 20 74 68 |it can c|hange th|
|00003b40| 65 20 62 75 74 74 6f 6e | 20 6d 61 73 6b 20 28 6c |e button| mask (l|
|00003b50| 65 61 76 69 6e 67 20 74 | 68 65 20 73 20 62 69 74 |eaving t|he s bit|
|00003b60| 20 61 74 20 30 29 2e 20 | 54 68 65 20 61 70 70 6c | at 0). |The appl|
|00003b70| 69 63 61 74 69 6f 6e 20 | 73 68 6f 75 6c 64 20 73 |ication |should s|
|00003b80| 61 76 65 20 74 68 65 20 | 6d 61 73 6b 20 62 65 66 |ave the |mask bef|
|00003b90| 6f 72 65 20 72 65 70 6c | 61 63 69 6e 67 20 69 74 |ore repl|acing it|
|00003ba0| 20 77 69 74 68 20 69 74 | 73 20 6f 77 6e 20 73 65 | with it|s own se|
|00003bb0| 74 74 69 6e 67 73 2e 20 | 4d 6f 75 73 65 20 65 76 |ttings. |Mouse ev|
|00003bc0| 65 6e 74 73 20 6d 61 79 | 20 6f 72 20 6d 61 79 20 |ents may| or may |
|00003bd0| 6e 6f 74 20 63 6f 6e 74 | 69 6e 75 65 20 74 6f 20 |not cont|inue to |
|00003be0| 62 65 20 72 65 63 65 69 | 76 65 64 20 64 65 70 65 |be recei|ved depe|
|00003bf0| 6e 64 69 6e 67 20 6f 6e | 20 77 68 65 74 68 65 72 |nding on| whether|
|00003c00| 20 74 68 65 20 61 70 70 | 6c 69 63 61 74 69 6f 6e | the app|lication|
|00003c10| 20 68 61 73 20 74 61 6b | 65 6e 20 63 6f 6e 74 72 | has tak|en contr|
|00003c20| 6f 6c 20 6f 66 20 74 68 | 65 20 6d 6f 75 73 65 20 |ol of th|e mouse |
|00003c30| 66 75 6e 63 74 69 6f 6e | 20 62 75 74 74 6f 6e 28 |function| button(|
|00003c40| 73 29 2e 20 55 70 6f 6e | 20 74 65 72 6d 69 6e 61 |s). Upon| termina|
|00003c50| 74 69 6f 6e 20 74 68 65 | 20 61 70 70 6c 69 63 61 |tion the| applica|
|00003c60| 74 69 6f 6e 20 73 68 6f | 75 6c 64 20 72 65 73 74 |tion sho|uld rest|
|00003c70| 6f 72 65 20 74 68 65 20 | 62 75 74 74 6f 6e 20 6d |ore the |button m|
|00003c80| 61 73 6b 2e 0d 54 68 65 | 20 6d 6f 75 73 65 2d 64 |ask..The| mouse-d|
|00003c90| 6f 77 6e 20 70 72 65 73 | 73 75 72 65 20 74 68 72 |own pres|sure thr|
|00003ca0| 65 73 68 6f 6c 64 20 69 | 73 20 62 61 73 69 63 61 |eshold i|s basica|
|00003cb0| 6c 6c 79 20 69 6e 74 65 | 6e 64 65 64 20 74 6f 20 |lly inte|nded to |
|00003cc0| 62 65 20 61 20 72 65 61 | 64 2d 6f 6e 6c 79 20 66 |be a rea|d-only f|
|00003cd0| 69 65 6c 64 2e 20 49 74 | 20 69 6e 64 69 63 61 74 |ield. It| indicat|
|00003ce0| 65 73 20 74 68 65 20 75 | 73 65 72 d5 73 20 70 72 |es the u|ser.s pr|
|00003cf0| 65 66 65 72 65 6e 63 65 | 20 66 6f 72 20 74 68 65 |eference| for the|
|00003d00| 20 61 6d 6f 75 6e 74 20 | 6f 66 20 70 72 65 73 73 | amount |of press|
|00003d10| 75 72 65 20 74 6f 20 62 | 65 20 65 78 65 72 74 65 |ure to b|e exerte|
|00003d20| 64 20 66 6f 72 20 61 20 | 6d 6f 75 73 65 2d 64 6f |d for a |mouse-do|
|00003d30| 77 6e 20 74 6f 20 6f 63 | 63 75 72 2e 20 41 6c 74 |wn to oc|cur. Alt|
|00003d40| 68 6f 75 67 68 20 69 74 | d5 73 20 6e 6f 74 20 61 |hough it|.s not a|
|00003d50| 64 76 69 73 65 64 2c 20 | 61 6e 20 61 70 70 6c 69 |dvised, |an appli|
|00003d60| 63 61 74 69 6f 6e 20 63 | 61 6e 20 6f 76 65 72 77 |cation c|an overw|
|00003d70| 72 69 74 65 20 74 68 69 | 73 20 66 69 65 6c 64 20 |rite thi|s field |
|00003d80| 77 69 74 68 20 69 74 73 | 20 6f 77 6e 20 76 61 6c |with its| own val|
|00003d90| 75 65 20 61 6e 64 20 72 | 65 73 74 6f 72 65 20 69 |ue and r|estore i|
|00003da0| 74 20 75 70 6f 6e 20 74 | 65 72 6d 69 6e 61 74 69 |t upon t|erminati|
|00003db0| 6f 6e 2e 0d 33 2e 09 57 | 68 65 6e 20 61 6e 20 61 |on..3..W|hen an a|
|00003dc0| 70 70 6c 69 63 61 74 69 | 6f 6e 20 74 65 72 6d 69 |pplicati|on termi|
|00003dd0| 6e 61 74 65 73 20 69 74 | 20 73 68 6f 75 6c 64 20 |nates it| should |
|00003de0| 72 65 73 74 6f 72 65 20 | 61 6e 79 20 70 61 72 61 |restore |any para|
|00003df0| 6d 65 74 65 72 73 20 69 | 74 20 6d 61 79 20 68 61 |meters i|t may ha|
|00003e00| 76 65 20 63 68 61 6e 67 | 65 64 2e 20 0d 46 75 72 |ve chang|ed. .Fur|
|00003e10| 74 68 65 72 20 52 65 66 | 65 72 65 6e 63 65 3a 0d |ther Ref|erence:.|
|00003e20| a5 09 49 6e 73 69 64 65 | 20 4d 61 63 69 6e 74 6f |..Inside| Macinto|
|00003e30| 73 68 2c 20 56 6f 6c 75 | 6d 65 20 56 2c 20 54 68 |sh, Volu|me V, Th|
|00003e40| 65 20 41 70 70 6c 65 20 | 44 65 73 6b 74 6f 70 20 |e Apple |Desktop |
|00003e50| 42 75 73 0d a5 09 54 65 | 63 68 6e 69 63 61 6c 20 |Bus...Te|chnical |
|00003e60| 4e 6f 74 65 20 4d 2e 48 | 57 2e 41 44 42 d1 0d 09 |Note M.H|W.ADB...|
|00003e70| 53 70 61 63 65 20 41 6c | 69 65 6e 73 20 41 74 65 |Space Al|iens Ate|
|00003e80| 20 4d 79 20 4d 6f 75 73 | 65 20 28 41 44 42 d1 54 | My Mous|e (ADB.T|
|00003e90| 68 65 20 55 6e 74 6f 6c | 64 20 53 74 6f 72 79 29 |he Untol|d Story)|
|00003ea0| 0d a5 09 4d 61 63 44 54 | 53 20 53 61 6d 70 6c 65 |...MacDT|S Sample|
|00003eb0| 20 43 6f 64 65 20 23 31 | 37 2c 20 54 62 6c 74 44 | Code #1|7, TbltD|
|00003ec0| 72 76 72 0d 44 56 20 32 | 20 2d 20 5f 41 64 64 44 |rvr.DV 2| - _AddD|
|00003ed0| 72 69 76 65 2c 20 5f 44 | 72 76 72 49 6e 73 74 61 |rive, _D|rvrInsta|
|00003ee0| 6c 6c 2c 20 61 6e 64 20 | 5f 44 72 76 72 52 65 6d |ll, and |_DrvrRem|
|00003ef0| 6f 76 65 0d 44 65 76 69 | 63 65 73 09 0d 52 65 76 |ove.Devi|ces..Rev|
|00003f00| 69 73 65 64 20 62 79 3a | 09 50 65 74 65 20 48 65 |ised by:|.Pete He|
|00003f10| 6c 6d 65 09 44 65 63 65 | 6d 62 65 72 20 31 39 38 |lme.Dece|mber 198|
|00003f20| 38 0d 57 72 69 74 74 65 | 6e 20 62 79 3a 09 4a 69 |8.Writte|n by:.Ji|
|00003f30| 6d 20 46 72 69 65 64 6c | 61 6e 64 65 72 09 4d 61 |m Friedl|ander.Ma|
|00003f40| 72 63 68 20 31 39 38 37 | 0d 5f 41 64 64 44 72 69 |rch 1987|._AddDri|
|00003f50| 76 65 2c 20 5f 44 72 76 | 72 49 6e 73 74 61 6c 6c |ve, _Drv|rInstall|
|00003f60| 2c 20 61 6e 64 20 5f 44 | 72 76 72 52 65 6d 6f 76 |, and _D|rvrRemov|
|00003f70| 65 20 61 72 65 20 75 73 | 65 64 20 69 6e 20 74 68 |e are us|ed in th|
|00003f80| 65 20 73 61 6d 70 6c 65 | 20 53 43 53 49 20 64 72 |e sample| SCSI dr|
|00003f90| 69 76 65 72 20 69 6e 20 | 74 68 65 20 53 43 53 49 |iver in |the SCSI|
|00003fa0| 20 44 65 76 65 6c 6f 70 | 6d 65 6e 74 20 50 61 63 | Develop|ment Pac|
|00003fb0| 6b 61 67 65 2c 20 77 68 | 69 63 68 20 69 73 20 61 |kage, wh|ich is a|
|00003fc0| 76 61 69 6c 61 62 6c 65 | 20 66 72 6f 6d 20 41 50 |vailable| from AP|
|00003fd0| 44 41 2e 20 20 54 68 69 | 73 20 54 65 63 68 6e 69 |DA. Thi|s Techni|
|00003fe0| 63 61 6c 20 4e 6f 74 65 | 20 64 6f 63 75 6d 65 6e |cal Note| documen|
|00003ff0| 74 73 20 74 68 65 20 70 | 61 72 61 6d 65 74 65 72 |ts the p|arameter|
|00004000| 73 20 66 6f 72 20 74 68 | 65 73 65 20 63 61 6c 6c |s for th|ese call|
|00004010| 73 2e 0d 43 68 61 6e 67 | 65 73 20 73 69 6e 63 65 |s..Chang|es since|
|00004020| 20 4d 61 72 63 68 20 31 | 2c 20 31 39 38 38 3a 20 | March 1|, 1988: |
|00004030| 20 55 70 64 61 74 65 64 | 20 74 68 65 20 5f 44 72 | Updated| the _Dr|
|00004040| 76 72 49 6e 73 74 61 6c | 6c 20 74 65 78 74 20 74 |vrInstal|l text t|
|00004050| 6f 20 72 65 66 6c 65 63 | 74 20 74 68 65 20 75 73 |o reflec|t the us|
|00004060| 65 20 6f 66 20 72 65 67 | 69 73 74 65 72 20 41 30 |e of reg|ister A0|
|00004070| 2c 20 77 68 69 63 68 20 | 73 68 6f 75 6c 64 20 63 |, which |should c|
|00004080| 6f 6e 74 61 69 6e 20 61 | 20 70 6f 69 6e 74 65 72 |ontain a| pointer|
|00004090| 20 74 6f 20 74 68 65 20 | 64 72 69 76 65 72 20 77 | to the |driver w|
|000040a0| 68 65 6e 20 63 61 6c 6c | 65 64 2e 20 20 41 6c 73 |hen call|ed. Als|
|000040b0| 6f 20 61 64 64 65 64 20 | 73 69 6d 70 6c 65 20 67 |o added |simple g|
|000040c0| 6c 75 65 20 63 6f 64 65 | 20 66 6f 72 20 5f 44 72 |lue code| for _Dr|
|000040d0| 76 72 49 6e 73 74 61 6c | 6c 20 61 6e 64 20 5f 44 |vrInstal|l and _D|
|000040e0| 72 76 72 52 65 6d 6f 76 | 65 20 73 69 6e 63 65 20 |rvrRemov|e since |
|000040f0| 6e 6f 6e 65 20 69 73 20 | 61 76 61 69 6c 61 62 6c |none is |availabl|
|00004100| 65 20 69 6e 20 74 68 65 | 20 4d 50 57 20 69 6e 74 |e in the| MPW int|
|00004110| 65 72 66 61 63 65 73 2e | 0d 5f 41 64 64 44 72 69 |erfaces.|._AddDri|
|00004120| 76 65 0d 5f 41 64 64 44 | 72 69 76 65 20 61 64 64 |ve._AddD|rive add|
|00004130| 73 20 61 20 64 72 69 76 | 65 20 74 6f 20 74 68 65 |s a driv|e to the|
|00004140| 20 64 72 69 76 65 20 71 | 75 65 75 65 2c 20 61 6e | drive q|ueue, an|
|00004150| 64 20 69 73 20 64 69 73 | 63 75 73 73 65 64 20 69 |d is dis|cussed i|
|00004160| 6e 20 6d 6f 72 65 20 64 | 65 74 61 69 6c 20 69 6e |n more d|etail in|
|00004170| 20 54 65 63 68 6e 69 63 | 61 6c 20 4e 6f 74 65 20 | Technic|al Note |
|00004180| 23 33 36 2c 20 44 72 69 | 76 65 20 51 75 65 75 65 |#36, Dri|ve Queue|
|00004190| 20 45 6c 65 6d 65 6e 74 | 73 3a 0d 20 20 20 20 20 | Element|s:. |
|000041a0| 20 20 20 46 55 4e 43 54 | 49 4f 4e 20 41 64 64 44 | FUNCT|ION AddD|
|000041b0| 72 69 76 65 28 44 51 45 | 3a 44 72 76 51 45 31 3b |rive(DQE|:DrvQE1;|
|000041c0| 64 72 69 76 65 4e 75 6d | 2c 72 65 66 4e 75 6d 3a |driveNum|,refNum:|
|000041d0| 49 4e 54 45 47 45 52 29 | 3a 4f 53 45 72 72 3b 0d |INTEGER)|:OSErr;.|
|000041e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000041f0| 41 30 20 28 69 6e 70 75 | 74 29 20 20 20 20 20 20 |A0 (inpu|t) |
|00004200| 20 20 20 20 20 20 20 20 | ae 20 20 20 20 20 70 6f | |. po|
|00004210| 69 6e 74 65 72 20 74 6f | 20 44 51 45 0d 20 20 20 |inter to| DQE. |
|00004220| 20 20 20 20 20 20 20 20 | 20 20 20 20 44 30 20 68 | | D0 h|
|00004230| 69 67 68 20 77 6f 72 64 | 28 69 6e 70 75 74 29 20 |igh word|(input) |
|00004240| 20 20 20 20 20 20 ae 20 | 20 20 20 20 64 72 69 76 | . | driv|
|00004250| 65 20 6e 75 6d 62 65 72 | 0d 20 20 20 20 20 20 20 |e number|. |
|00004260| 20 20 20 20 20 20 20 20 | 44 30 20 6c 6f 77 20 77 | |D0 low w|
|00004270| 6f 72 64 28 69 6e 70 75 | 74 29 20 20 20 20 20 20 |ord(inpu|t) |
|00004280| 20 20 ae 20 20 20 20 20 | 64 72 69 76 65 72 20 52 | . |driver R|
|00004290| 65 66 4e 75 6d 0d 20 20 | 20 20 20 20 20 20 20 20 |efNum. | |
|000042a0| 20 20 20 20 20 44 30 20 | 28 6f 75 74 70 75 74 29 | D0 |(output)|
|000042b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 ac 20 20 | | . |
|000042c0| 20 20 20 20 65 72 72 6f | 72 20 63 6f 64 65 0d 20 | erro|r code. |
|000042d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000042e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000042f0| 20 20 20 20 6e 6f 45 72 | 72 20 28 61 6c 77 61 79 | noEr|r (alway|
|00004300| 73 20 72 65 74 75 72 6e | 65 64 29 0d 5f 44 72 76 |s return|ed)._Drv|
|00004310| 72 49 6e 73 74 61 6c 6c | 0d 5f 44 72 76 72 49 6e |rInstall|._DrvrIn|
|00004320| 73 74 61 6c 6c 20 69 73 | 20 75 73 65 64 20 74 6f |stall is| used to|
|00004330| 20 69 6e 73 74 61 6c 6c | 20 61 20 64 72 69 76 65 | install| a drive|
|00004340| 72 2e 20 20 41 20 44 43 | 45 20 66 6f 72 20 74 68 |r. A DC|E for th|
|00004350| 65 20 64 72 69 76 65 72 | 20 69 73 20 63 72 65 61 |e driver| is crea|
|00004360| 74 65 64 20 61 6e 64 20 | 69 74 73 20 68 61 6e 64 |ted and |its hand|
|00004370| 6c 65 20 65 6e 74 65 72 | 65 64 20 69 6e 74 6f 20 |le enter|ed into |
|00004380| 74 68 65 20 73 70 65 63 | 69 66 69 65 64 20 55 6e |the spec|ified Un|
|00004390| 69 74 20 54 61 62 6c 65 | 20 70 6f 73 69 74 69 6f |it Table| positio|
|000043a0| 6e 20 28 d0 31 20 74 68 | 72 6f 75 67 68 20 d0 36 |n (.1 th|rough .6|
|000043b0| 34 29 2e 20 20 49 66 20 | 74 68 65 20 75 6e 69 74 |4). If |the unit|
|000043c0| 20 6e 75 6d 62 65 72 20 | 69 73 20 d0 34 20 74 68 | number |is .4 th|
|000043d0| 72 6f 75 67 68 20 d0 39 | 2c 20 74 68 65 20 63 6f |rough .9|, the co|
|000043e0| 72 72 65 73 70 6f 6e 64 | 69 6e 67 20 52 4f 4d 2d |rrespond|ing ROM-|
|000043f0| 62 61 73 65 64 20 64 72 | 69 76 65 72 20 77 69 6c |based dr|iver wil|
|00004400| 6c 20 62 65 20 72 65 70 | 6c 61 63 65 64 3a 0d 20 |l be rep|laced:. |
|00004410| 20 20 20 20 20 20 20 46 | 55 4e 43 54 49 4f 4e 20 | F|UNCTION |
|00004420| 44 72 76 72 49 6e 73 74 | 61 6c 6c 28 64 72 76 72 |DrvrInst|all(drvr|
|00004430| 48 61 6e 64 6c 65 3a 48 | 61 6e 64 6c 65 3b 20 72 |Handle:H|andle; r|
|00004440| 65 66 4e 75 6d 3a 20 49 | 4e 54 45 47 45 52 29 3a |efNum: I|NTEGER):|
|00004450| 20 4f 53 45 72 72 3b 0d | 20 20 20 20 20 20 20 20 | OSErr;.| |
|00004460| 20 20 20 20 20 20 20 41 | 30 20 28 69 6e 70 75 74 | A|0 (input|
|00004470| 29 20 20 20 20 20 20 20 | 20 ae 20 20 20 20 70 6f |) | . po|
|00004480| 69 6e 74 65 72 20 74 6f | 20 64 72 69 76 65 72 0d |inter to| driver.|
|00004490| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 44 | | D|
|000044a0| 30 20 28 69 6e 70 75 74 | 29 20 20 20 20 20 20 20 |0 (input|) |
|000044b0| 20 ae 20 20 20 20 64 72 | 69 76 65 72 20 52 65 66 | . dr|iver Ref|
|000044c0| 4e 75 6d 20 28 d0 31 20 | 74 68 72 6f 75 67 68 20 |Num (.1 |through |
|000044d0| d0 36 34 29 0d 20 20 20 | 20 20 20 20 20 20 20 20 |.64). | |
|000044e0| 20 20 20 20 44 30 20 28 | 6f 75 74 70 75 74 29 20 | D0 (|output) |
|000044f0| 20 20 20 20 20 20 ac 20 | 20 20 20 65 72 72 6f 72 | . | error|
|00004500| 20 63 6f 64 65 0d 20 20 | 20 20 20 20 20 20 20 20 | code. | |
|00004510| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00004520| 20 20 20 20 20 20 20 20 | 20 20 20 6e 6f 45 72 72 | | noErr|
|00004530| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. | |
|00004540| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00004550| 20 20 20 20 20 20 62 61 | 64 55 6e 69 74 45 72 72 | ba|dUnitErr|
|00004560| 0d 5f 44 72 76 72 52 65 | 6d 6f 76 65 0d 5f 44 72 |._DrvrRe|move._Dr|
|00004570| 76 72 52 65 6d 6f 76 65 | 20 69 73 20 75 73 65 64 |vrRemove| is used|
|00004580| 20 74 6f 20 72 65 6d 6f | 76 65 20 61 20 64 72 69 | to remo|ve a dri|
|00004590| 76 65 72 2e 20 20 41 20 | 52 41 4d 2d 62 61 73 65 |ver. A |RAM-base|
|000045a0| 64 20 64 72 69 76 65 72 | 20 69 73 20 70 75 72 67 |d driver| is purg|
|000045b0| 65 64 20 66 72 6f 6d 20 | 74 68 65 20 73 79 73 74 |ed from |the syst|
|000045c0| 65 6d 20 68 65 61 70 20 | 28 75 73 69 6e 67 20 5f |em heap |(using _|
|000045d0| 52 65 6c 65 61 73 65 52 | 65 73 6f 75 72 63 65 29 |ReleaseR|esource)|
|000045e0| 2e 20 20 4d 65 6d 6f 72 | 79 20 66 6f 72 20 74 68 |. Memor|y for th|
|000045f0| 65 20 44 43 45 20 69 73 | 20 64 69 73 70 6f 73 65 |e DCE is| dispose|
|00004600| 64 3a 0d 20 20 20 20 20 | 20 20 20 46 55 4e 43 54 |d:. | FUNCT|
|00004610| 49 4f 4e 20 44 72 76 72 | 52 65 6d 6f 76 65 28 72 |ION Drvr|Remove(r|
|00004620| 65 66 4e 75 6d 3a 20 49 | 4e 54 45 47 45 52 29 3a |efNum: I|NTEGER):|
|00004630| 4f 53 45 72 72 3b 0d 20 | 20 20 20 20 20 20 20 20 |OSErr;. | |
|00004640| 20 20 20 20 20 20 44 30 | 20 28 69 6e 70 75 74 29 | D0| (input)|
|00004650| 20 20 20 20 20 20 20 20 | ae 20 20 20 20 44 72 69 | |. Dri|
|00004660| 76 65 72 20 52 65 66 4e | 75 6d 0d 20 20 20 20 20 |ver RefN|um. |
|00004670| 20 20 20 20 20 20 20 20 | 20 20 44 30 20 28 6f 75 | | D0 (ou|
|00004680| 74 70 75 74 29 20 20 20 | 20 20 20 20 ac 20 20 20 |tput) | . |
|00004690| 20 65 72 72 6f 72 20 63 | 6f 64 65 20 0d 20 20 20 | error c|ode . |
|000046a0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000046b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000046c0| 20 6e 6f 45 72 72 0d 20 | 20 20 20 20 20 20 20 20 | noErr. | |
|000046d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000046e0| 20 20 20 20 20 20 20 20 | 20 20 20 71 45 72 72 0d | | qErr.|
|000046f0| 49 6e 74 65 72 66 61 63 | 65 73 0d 54 68 72 6f 75 |Interfac|es.Throu|
|00004700| 67 68 20 61 20 73 65 71 | 75 65 6e 63 65 20 6f 66 |gh a seq|uence of|
|00004710| 20 63 61 74 61 63 6c 79 | 73 6d 69 63 20 65 76 65 | catacly|smic eve|
|00004720| 6e 74 73 2c 20 74 68 65 | 20 67 6c 75 65 20 63 6f |nts, the| glue co|
|00004730| 64 65 20 66 6f 72 20 5f | 44 72 76 72 49 6e 73 74 |de for _|DrvrInst|
|00004740| 61 6c 6c 20 61 6e 64 20 | 5f 44 72 76 72 52 65 6d |all and |_DrvrRem|
|00004750| 6f 76 65 20 77 61 73 20 | 6e 65 76 65 72 20 61 63 |ove was |never ac|
|00004760| 74 75 61 6c 6c 79 20 61 | 64 64 65 64 20 74 6f 20 |tually a|dded to |
|00004770| 74 68 65 20 4d 50 57 20 | 69 6e 74 65 72 66 61 63 |the MPW |interfac|
|00004780| 65 73 20 28 69 2e 65 2e | 2c 20 d2 57 65 20 66 6f |es (i.e.|, .We fo|
|00004790| 72 67 6f 74 2e d3 29 2c | 20 73 6f 20 77 65 20 77 |rgot..),| so we w|
|000047a0| 69 6c 6c 20 69 6e 63 6c | 75 64 65 20 73 69 6d 70 |ill incl|ude simp|
|000047b0| 6c 65 20 67 6c 75 65 20 | 68 65 72 65 20 61 74 20 |le glue |here at |
|000047c0| 6e 6f 20 65 78 74 72 61 | 20 65 78 70 65 6e 73 65 |no extra| expense|
|000047d0| 20 74 6f 20 79 6f 75 2e | 0d 49 74 20 77 6f 75 6c | to you.|.It woul|
|000047e0| 64 20 62 65 20 61 64 76 | 69 73 61 62 6c 65 20 74 |d be adv|isable t|
|000047f0| 6f 20 66 69 72 73 74 20 | 6c 6f 63 6b 20 74 68 65 |o first |lock the|
|00004800| 20 68 61 6e 64 6c 65 20 | 74 6f 20 79 6f 75 72 20 | handle |to your |
|00004810| 64 72 69 76 65 72 20 77 | 69 74 68 20 5f 48 4c 6f |driver w|ith _HLo|
|00004820| 63 6b 20 62 65 66 6f 72 | 65 20 6d 61 6b 69 6e 67 |ck befor|e making|
|00004830| 20 65 69 74 68 65 72 20 | 6f 66 20 74 68 65 73 65 | either |of these|
|00004840| 20 63 61 6c 6c 73 20 73 | 69 6e 63 65 20 6d 65 6d | calls s|ince mem|
|00004850| 6f 72 79 20 6d 61 79 20 | 62 65 20 6d 6f 76 65 64 |ory may |be moved|
|00004860| 2e 0d 20 20 20 20 20 20 | 20 3b 2d 2d 2d 2d 2d 2d |.. | ;------|
|00004870| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004880| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004890| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000048a0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 0d 20 20 20 20 20 20 |--------|-. |
|000048b0| 20 3b 20 46 55 4e 43 54 | 49 4f 4e 20 44 52 56 52 | ; FUNCT|ION DRVR|
|000048c0| 49 6e 73 74 61 6c 6c 28 | 64 72 76 72 48 61 6e 64 |Install(|drvrHand|
|000048d0| 6c 65 3a 48 61 6e 64 6c | 65 3b 20 72 65 66 4e 75 |le:Handl|e; refNu|
|000048e0| 6d 3a 49 4e 54 45 47 45 | 52 29 3a 4f 53 45 72 72 |m:INTEGE|R):OSErr|
|000048f0| 3b 0d 20 20 20 20 20 20 | 20 3b 2d 2d 2d 2d 2d 2d |;. | ;------|
|00004900| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004910| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004920| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004930| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 0d 20 20 20 20 20 20 |--------|-. |
|00004940| 20 44 52 56 52 49 6e 73 | 74 61 6c 6c 20 20 20 20 | DRVRIns|tall |
|00004950| 20 20 50 52 4f 43 20 20 | 20 20 45 58 50 4f 52 54 | PROC | EXPORT|
|00004960| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 4d |. | M|
|00004970| 4f 56 45 41 2e 4c 20 20 | 20 20 20 20 20 20 20 20 |OVEA.L | |
|00004980| 20 28 53 50 29 2b 2c 20 | 41 31 20 20 20 20 3b 20 | (SP)+, |A1 ; |
|00004990| 70 6f 70 20 72 65 74 75 | 72 6e 20 61 64 64 72 65 |pop retu|rn addre|
|000049a0| 73 73 0d 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |ss. | |
|000049b0| 20 4d 4f 56 45 2e 57 09 | 20 20 20 20 20 20 20 20 | MOVE.W.| |
|000049c0| 20 20 28 53 50 29 2b 2c | 20 44 30 20 20 20 20 3b | (SP)+,| D0 ;|
|000049d0| 20 64 72 69 76 65 72 20 | 72 65 66 65 72 65 6e 63 | driver |referenc|
|000049e0| 65 20 6e 75 6d 62 65 72 | 0d 20 20 20 20 20 20 20 |e number|. |
|000049f0| 20 20 20 20 20 20 20 4d | 4f 56 45 41 2e 4c 20 20 | M|OVEA.L |
|00004a00| 20 20 20 20 20 20 20 20 | 20 28 53 50 29 2b 2c 20 | | (SP)+, |
|00004a10| 41 30 20 20 20 20 3b 20 | 68 61 6e 64 6c 65 20 74 |A0 ; |handle t|
|00004a20| 6f 20 64 72 69 76 65 72 | 20 0d 20 20 20 20 20 20 |o driver| . |
|00004a30| 20 20 20 20 20 20 20 20 | 4d 4f 56 45 41 2e 4c 20 | |MOVEA.L |
|00004a40| 20 20 20 20 20 20 20 20 | 20 20 28 41 30 29 2c 20 | | (A0), |
|00004a50| 41 30 20 20 20 20 20 3b | 20 70 6f 69 6e 74 65 72 |A0 ;| pointer|
|00004a60| 20 74 6f 20 64 72 69 76 | 65 72 0d 20 20 20 20 20 | to driv|er. |
|00004a70| 20 20 20 20 20 20 20 20 | 20 5f 44 72 76 72 49 6e | | _DrvrIn|
|00004a80| 73 74 61 6c 6c 20 20 20 | 20 20 20 20 20 20 20 20 |stall | |
|00004a90| 20 20 20 20 20 20 20 20 | 3b 20 24 41 30 33 44 0d | |; $A03D.|
|00004aa0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 4d 4f | | MO|
|00004ab0| 56 45 2e 57 20 20 20 20 | 20 20 20 20 20 20 20 20 |VE.W | |
|00004ac0| 44 30 2c 20 28 53 50 29 | 20 20 20 20 20 3b 20 67 |D0, (SP)| ; g|
|00004ad0| 65 74 20 65 72 72 6f 72 | 0d 20 20 20 20 20 20 20 |et error|. |
|00004ae0| 20 20 20 20 20 20 20 4a | 4d 50 20 20 20 20 20 20 | J|MP |
|00004af0| 20 20 20 20 20 20 20 20 | 20 28 41 31 29 20 20 20 | | (A1) |
|00004b00| 20 20 20 20 20 20 3b 20 | 26 20 73 70 6c 69 74 0d | ; |& split.|
|00004b10| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 45 4e | | EN|
|00004b20| 44 50 50 52 4f 43 0d 20 | 20 20 20 20 20 20 3b 2d |DPPROC. | ;-|
|00004b30| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b40| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b50| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004b60| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 0d 20 |--------|------. |
|00004b70| 20 20 20 20 20 20 3b 20 | 46 55 4e 43 54 49 4f 4e | ; |FUNCTION|
|00004b80| 20 44 52 56 52 52 65 6d | 6f 76 65 28 72 65 66 4e | DRVRRem|ove(refN|
|00004b90| 75 6d 3a 49 4e 54 45 47 | 45 52 29 3a 4f 53 45 72 |um:INTEG|ER):OSEr|
|00004ba0| 72 3b 0d 20 20 20 20 20 | 20 20 3b 2d 2d 2d 2d 2d |r;. | ;-----|
|00004bb0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004bc0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004bd0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00004be0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 0d 20 20 20 20 20 |--------|--. |
|00004bf0| 20 20 44 52 56 52 52 65 | 6d 6f 76 65 20 20 20 20 | DRVRRe|move |
|00004c00| 20 20 50 52 4f 43 20 20 | 20 20 45 58 50 4f 52 54 | PROC | EXPORT|
|00004c10| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 4d |. | M|
|00004c20| 4f 56 45 41 2e 4c 20 20 | 20 20 20 20 20 20 20 20 |OVEA.L | |
|00004c30| 28 53 50 29 2b 2c 20 41 | 31 20 20 20 20 3b 20 70 |(SP)+, A|1 ; p|
|00004c40| 6f 70 20 72 65 74 75 72 | 6e 20 61 64 64 72 65 73 |op retur|n addres|
|00004c50| 73 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |s. | |
|00004c60| 4d 4f 56 45 2e 57 20 20 | 20 20 20 20 20 20 20 20 |MOVE.W | |
|00004c70| 20 28 53 50 29 2b 2c 20 | 44 30 20 20 20 20 3b 20 | (SP)+, |D0 ; |
|00004c80| 64 72 69 76 65 72 20 72 | 65 66 65 72 65 6e 63 65 |driver r|eference|
|00004c90| 20 6e 75 6d 62 65 72 0d | 20 20 20 20 20 20 20 20 | number.| |
|00004ca0| 20 20 20 20 20 20 5f 44 | 72 76 72 52 65 6d 6f 76 | _D|rvrRemov|
|00004cb0| 65 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |e | |
|00004cc0| 20 20 20 20 3b 20 24 41 | 30 33 45 0d 20 20 20 20 | ; $A|03E. |
|00004cd0| 20 20 20 20 20 20 20 20 | 20 20 4d 4f 56 45 2e 57 | | MOVE.W|
|00004ce0| 20 20 20 20 20 20 20 20 | 20 20 20 44 30 2c 20 28 | | D0, (|
|00004cf0| 53 50 29 20 20 20 20 20 | 3b 20 67 65 74 20 65 72 |SP) |; get er|
|00004d00| 72 6f 72 0d 20 20 20 20 | 20 20 20 20 20 20 20 20 |ror. | |
|00004d10| 20 20 4a 4d 50 20 20 20 | 20 20 20 20 20 20 20 20 | JMP | |
|00004d20| 20 20 20 28 41 31 29 20 | 20 20 20 20 20 20 20 20 | (A1) | |
|00004d30| 3b 20 26 20 73 70 6c 69 | 74 0d 20 20 20 20 20 20 |; & spli|t. |
|00004d40| 20 20 20 20 20 20 20 20 | 45 4e 44 50 50 52 4f 43 | |ENDPPROC|
|00004d50| 0d 44 56 20 33 20 2d 20 | 42 6f 6f 74 20 42 6c 6f |.DV 3 - |Boot Blo|
|00004d60| 63 6b 73 0d 44 65 76 69 | 63 65 73 09 52 65 76 69 |cks.Devi|ces.Revi|
|00004d70| 73 65 64 20 62 79 3a 09 | 09 4d 61 72 63 68 20 31 |sed by:.|.March 1|
|00004d80| 39 38 38 0d 57 72 69 74 | 74 65 6e 20 62 79 3a 09 |988.Writ|ten by:.|
|00004d90| 42 6f 62 20 4a 6f 68 6e | 73 6f 6e 09 4d 61 72 63 |Bob John|son.Marc|
|00004da0| 68 20 31 39 38 37 0d 54 | 68 65 72 65 20 61 72 65 |h 1987.T|here are|
|00004db0| 20 74 77 6f 20 75 6e 64 | 6f 63 75 6d 65 6e 74 65 | two und|ocumente|
|00004dc0| 64 20 66 65 61 74 75 72 | 65 73 20 6f 66 20 74 68 |d featur|es of th|
|00004dd0| 65 20 42 6f 6f 74 20 42 | 6c 6f 63 6b 73 2e 20 54 |e Boot B|locks. T|
|00004de0| 68 69 73 20 6e 6f 74 65 | 20 77 69 6c 6c 20 64 65 |his note| will de|
|00004df0| 73 63 72 69 62 65 20 68 | 6f 77 20 74 68 65 79 20 |scribe h|ow they |
|00004e00| 63 75 72 72 65 6e 74 6c | 79 20 77 6f 72 6b 2e 0d |currentl|y work..|
|00004e10| 57 61 72 6e 69 6e 67 3a | 09 54 68 65 20 66 6f 72 |Warning:|.The for|
|00004e20| 6d 61 74 20 61 6e 64 20 | 66 75 6e 63 74 69 6f 6e |mat and |function|
|00004e30| 61 6c 69 74 79 20 6f 66 | 20 74 68 65 20 42 6f 6f |ality of| the Boo|
|00004e40| 74 20 42 6c 6f 63 6b 73 | 20 77 69 6c 6c 20 63 68 |t Blocks| will ch|
|00004e50| 61 6e 67 65 20 69 6e 20 | 74 68 65 20 66 75 74 75 |ange in |the futu|
|00004e60| 72 65 3b 20 64 65 70 65 | 6e 64 65 6e 63 65 20 6f |re; depe|ndence o|
|00004e70| 6e 20 74 68 69 73 20 69 | 6e 66 6f 72 6d 61 74 69 |n this i|nformati|
|00004e80| 6f 6e 20 6d 61 79 20 63 | 61 75 73 65 20 79 6f 75 |on may c|ause you|
|00004e90| 72 20 70 72 6f 67 72 61 | 6d 20 74 6f 20 66 61 69 |r progra|m to fai|
|00004ea0| 6c 20 6f 6e 20 66 75 74 | 75 72 65 20 68 61 72 64 |l on fut|ure hard|
|00004eb0| 77 61 72 65 20 6f 72 20 | 77 69 74 68 20 66 75 74 |ware or |with fut|
|00004ec0| 75 72 65 20 53 79 73 74 | 65 6d 20 73 6f 66 74 77 |ure Syst|em softw|
|00004ed0| 61 72 65 2e 0d 54 68 65 | 20 66 69 72 73 74 20 74 |are..The| first t|
|00004ee0| 77 6f 20 73 65 63 74 6f | 72 73 20 6f 66 20 61 20 |wo secto|rs of a |
|00004ef0| 62 6f 6f 74 61 62 6c 65 | 20 4d 61 63 69 6e 74 6f |bootable| Macinto|
|00004f00| 73 68 20 64 69 73 6b 20 | 61 72 65 20 75 73 65 64 |sh disk |are used|
|00004f10| 20 74 6f 20 73 74 6f 72 | 65 20 69 6e 66 6f 72 6d | to stor|e inform|
|00004f20| 61 74 69 6f 6e 20 6f 6e | 20 68 6f 77 20 74 6f 20 |ation on| how to |
|00004f30| 73 74 61 72 74 20 75 70 | 20 74 68 65 20 63 6f 6d |start up| the com|
|00004f40| 70 75 74 65 72 2e 20 54 | 68 65 20 62 6c 6f 63 6b |puter. T|he block|
|00004f50| 73 20 63 6f 6e 74 61 69 | 6e 20 76 61 72 69 6f 75 |s contai|n variou|
|00004f60| 73 20 70 61 72 61 6d 65 | 74 65 72 73 20 74 68 61 |s parame|ters tha|
|00004f70| 74 20 74 68 65 20 73 79 | 73 74 65 6d 20 75 73 65 |t the sy|stem use|
|00004f80| 73 20 74 6f 20 73 74 61 | 72 74 75 70 20 73 75 63 |s to sta|rtup suc|
|00004f90| 68 20 61 73 20 74 68 65 | 20 6e 61 6d 65 20 6f 66 |h as the| name of|
|00004fa0| 20 74 68 65 20 73 79 73 | 74 65 6d 20 66 69 6c 65 | the sys|tem file|
|00004fb0| 2c 20 74 68 65 20 6e 61 | 6d 65 20 6f 66 20 74 68 |, the na|me of th|
|00004fc0| 65 20 46 69 6e 64 65 72 | 2c 20 74 68 65 20 66 69 |e Finder|, the fi|
|00004fd0| 72 73 74 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |rst appl|ication |
|00004fe0| 74 6f 20 72 75 6e 20 61 | 74 20 62 6f 6f 74 20 74 |to run a|t boot t|
|00004ff0| 69 6d 65 2c 20 74 68 65 | 20 6e 75 6d 62 65 72 20 |ime, the| number |
|00005000| 6f 66 20 65 76 65 6e 74 | 73 20 74 6f 20 61 6c 6c |of event|s to all|
|00005010| 6f 77 2c 20 65 74 63 2e | 0d 43 68 61 6e 67 69 6e |ow, etc.|.Changin|
|00005020| 67 20 53 79 73 74 65 6d | 20 48 65 61 70 20 53 69 |g System| Heap Si|
|00005030| 7a 65 0d 54 68 65 20 62 | 6f 6f 74 20 62 6c 6f 63 |ze.The b|oot bloc|
|00005040| 6b 73 20 64 69 63 74 61 | 74 65 20 77 68 61 74 20 |ks dicta|te what |
|00005050| 73 69 7a 65 20 74 68 65 | 20 73 79 73 74 65 6d 20 |size the| system |
|00005060| 68 65 61 70 20 77 69 6c | 6c 20 62 65 20 61 66 74 |heap wil|l be aft|
|00005070| 65 72 20 62 6f 6f 74 69 | 6e 67 2e 20 41 6e 79 20 |er booti|ng. Any |
|00005080| 63 6f 6d 6d 6f 6e 20 73 | 65 63 74 6f 72 20 65 64 |common s|ector ed|
|00005090| 69 74 69 6e 67 20 70 72 | 6f 67 72 61 6d 20 77 69 |iting pr|ogram wi|
|000050a0| 6c 6c 20 61 6c 6c 6f 77 | 20 79 6f 75 20 74 6f 20 |ll allow| you to |
|000050b0| 63 68 61 6e 67 65 20 74 | 68 65 20 64 61 74 61 20 |change t|he data |
|000050c0| 69 6e 20 74 68 65 20 62 | 6f 6f 74 20 62 6c 6f 63 |in the b|oot bloc|
|000050d0| 6b 73 2e 20 43 68 61 6e | 67 69 6e 67 20 74 68 65 |ks. Chan|ging the|
|000050e0| 20 73 79 73 74 65 6d 20 | 68 65 61 70 20 73 69 7a | system |heap siz|
|000050f0| 65 20 69 73 20 61 63 63 | 6f 6d 70 6c 69 73 68 65 |e is acc|omplishe|
|00005100| 64 20 62 79 20 63 68 61 | 6e 67 69 6e 67 20 74 77 |d by cha|nging tw|
|00005110| 6f 20 70 61 72 61 6d 65 | 74 65 72 73 20 69 6e 20 |o parame|ters in |
|00005120| 74 68 65 20 62 6f 6f 74 | 20 62 6c 6f 63 6b 73 3a |the boot| blocks:|
|00005130| 20 74 68 65 20 6c 6f 6e | 67 20 77 6f 72 64 20 76 | the lon|g word v|
|00005140| 61 6c 75 65 20 61 74 20 | 6c 6f 63 61 74 69 6f 6e |alue at |location|
|00005150| 20 24 38 36 20 69 6e 20 | 42 6c 6f 63 6b 20 30 20 | $86 in |Block 0 |
|00005160| 69 6e 64 69 63 61 74 65 | 73 20 74 68 65 20 73 69 |indicate|s the si|
|00005170| 7a 65 20 6f 66 20 74 68 | 65 20 73 79 73 74 65 6d |ze of th|e system|
|00005180| 20 68 65 61 70 3b 20 74 | 68 65 20 77 6f 72 64 20 | heap; t|he word |
|00005190| 76 61 6c 75 65 20 61 74 | 20 6c 6f 63 61 74 69 6f |value at| locatio|
|000051a0| 6e 20 24 36 20 69 73 20 | 74 68 65 20 76 65 72 73 |n $6 is |the vers|
|000051b0| 69 6f 6e 20 6e 75 6d 62 | 65 72 20 6f 66 20 74 68 |ion numb|er of th|
|000051c0| 65 20 62 6f 6f 74 20 62 | 6c 6f 63 6b 73 2e 20 43 |e boot b|locks. C|
|000051d0| 68 61 6e 67 69 6e 67 20 | 74 68 65 20 76 65 72 73 |hanging |the vers|
|000051e0| 69 6f 6e 20 6e 75 6d 62 | 65 72 20 74 6f 20 62 65 |ion numb|er to be|
|000051f0| 20 67 72 65 61 74 65 72 | 20 74 68 61 6e 20 24 31 | greater| than $1|
|00005200| 34 20 28 24 31 35 20 69 | 73 20 72 65 63 6f 6d 6d |4 ($15 i|s recomm|
|00005210| 65 6e 64 65 64 29 20 74 | 65 6c 6c 73 20 74 68 65 |ended) t|ells the|
|00005220| 20 52 4f 4d 20 74 6f 20 | 75 73 65 20 74 68 65 20 | ROM to |use the |
|00005230| 76 61 6c 75 65 20 61 74 | 20 24 38 36 20 66 6f 72 |value at| $86 for|
|00005240| 20 74 68 65 20 73 79 73 | 74 65 6d 20 68 65 61 70 | the sys|tem heap|
|00005250| 20 73 69 7a 65 2c 20 6f | 74 68 65 72 77 69 73 65 | size, o|therwise|
|00005260| 20 74 68 65 20 76 61 6c | 75 65 20 61 74 20 24 38 | the val|ue at $8|
|00005270| 36 20 69 73 20 69 67 6e | 6f 72 65 64 2e 20 54 68 |6 is ign|ored. Th|
|00005280| 65 20 24 38 36 20 6c 6f | 63 61 74 69 6f 6e 20 6f |e $86 lo|cation o|
|00005290| 6e 6c 79 20 61 70 70 6c | 69 65 73 20 74 6f 20 63 |nly appl|ies to c|
|000052a0| 6f 6d 70 75 74 65 72 73 | 20 77 69 74 68 20 6d 6f |omputers| with mo|
|000052b0| 72 65 20 74 68 61 6e 20 | 31 32 38 4b 20 6f 66 20 |re than |128K of |
|000052c0| 52 41 4d 2e 20 0d 53 65 | 63 6f 6e 64 61 72 79 20 |RAM. .Se|condary |
|000052d0| 53 6f 75 6e 64 20 61 6e | 64 20 56 69 64 65 6f 20 |Sound an|d Video |
|000052e0| 50 61 67 65 73 0d 41 6e | 6f 74 68 65 72 20 6f 63 |Pages.An|other oc|
|000052f0| 63 61 73 69 6f 6e 61 6c | 6c 79 20 75 73 65 66 75 |casional|ly usefu|
|00005300| 6c 20 66 65 61 74 75 72 | 65 20 6f 66 20 74 68 65 |l featur|e of the|
|00005310| 20 62 6f 6f 74 20 62 6c | 6f 63 6b 73 20 69 73 20 | boot bl|ocks is |
|00005320| 74 68 65 20 61 62 69 6c | 69 74 79 20 74 6f 20 73 |the abil|ity to s|
|00005330| 70 65 63 69 66 79 20 74 | 68 61 74 20 74 68 65 20 |pecify t|hat the |
|00005340| 73 65 63 6f 6e 64 61 72 | 79 20 73 6f 75 6e 64 20 |secondar|y sound |
|00005350| 61 6e 64 20 76 69 64 65 | 6f 20 70 61 67 65 73 20 |and vide|o pages |
|00005360| 62 65 20 61 6c 6c 6f 63 | 61 74 65 64 20 61 74 20 |be alloc|ated at |
|00005370| 62 6f 6f 74 20 74 69 6d | 65 2e 20 54 68 69 73 20 |boot tim|e. This |
|00005380| 69 73 20 64 6f 6e 65 20 | 62 65 66 6f 72 65 20 61 |is done |before a|
|00005390| 20 64 65 62 75 67 67 65 | 72 20 69 73 20 6c 6f 61 | debugge|r is loa|
|000053a0| 64 65 64 2c 20 73 6f 20 | 74 68 65 20 64 65 62 75 |ded, so |the debu|
|000053b0| 67 67 65 72 20 77 69 6c | 6c 20 6c 6f 61 64 20 62 |gger wil|l load b|
|000053c0| 65 6c 6f 77 20 74 68 65 | 20 61 6c 74 65 72 6e 61 |elow the| alterna|
|000053d0| 74 65 20 73 63 72 65 65 | 6e 2e 20 54 68 69 73 20 |te scree|n. This |
|000053e0| 69 73 20 75 73 65 66 75 | 6c 20 66 6f 72 20 64 65 |is usefu|l for de|
|000053f0| 62 75 67 67 69 6e 67 20 | 73 6f 66 74 77 61 72 65 |bugging |software|
|00005400| 20 74 68 61 74 20 75 73 | 65 73 20 74 68 65 20 61 | that us|es the a|
|00005410| 6c 74 65 72 6e 61 74 65 | 20 76 69 64 65 6f 20 70 |lternate| video p|
|00005420| 61 67 65 2c 20 6c 69 6b | 65 20 70 61 67 65 2d 66 |age, lik|e page-f|
|00005430| 6c 69 70 70 69 6e 67 20 | 64 65 6d 6f 73 20 6f 72 |lipping |demos or|
|00005440| 20 67 61 6d 65 73 2e 20 | 54 6f 20 61 6c 6c 6f 63 | games. |To alloc|
|00005450| 61 74 65 20 74 68 65 20 | 73 65 63 6f 6e 64 20 76 |ate the |second v|
|00005460| 69 64 65 6f 20 61 6e 64 | 20 73 6f 75 6e 64 20 62 |ideo and| sound b|
|00005470| 75 66 66 65 72 73 2c 20 | 63 68 61 6e 67 65 20 74 |uffers, |change t|
|00005480| 68 65 20 74 77 6f 20 62 | 79 74 65 73 20 73 74 61 |he two b|ytes sta|
|00005490| 72 74 69 6e 67 20 61 74 | 20 6c 6f 63 61 74 69 6f |rting at| locatio|
|000054a0| 6e 20 24 38 20 69 6e 20 | 74 68 65 20 62 6f 6f 74 |n $8 in |the boot|
|000054b0| 20 62 6c 6f 63 6b 73 2e | 20 43 68 61 6e 67 65 20 | blocks.| Change |
|000054c0| 74 68 65 20 76 61 6c 75 | 65 20 28 6e 6f 72 6d 61 |the valu|e (norma|
|000054d0| 6c 6c 79 20 30 29 20 74 | 6f 20 61 20 6e 65 67 61 |lly 0) t|o a nega|
|000054e0| 74 69 76 65 20 6e 75 6d | 62 65 72 20 28 24 46 46 |tive num|ber ($FF|
|000054f0| 46 46 29 20 74 6f 20 61 | 6c 6c 6f 63 61 74 65 20 |FF) to a|llocate |
|00005500| 62 6f 74 68 20 76 69 64 | 65 6f 20 61 6e 64 20 73 |both vid|eo and s|
|00005510| 6f 75 6e 64 20 62 75 66 | 66 65 72 73 2e 20 43 68 |ound buf|fers. Ch|
|00005520| 61 6e 67 65 20 74 68 65 | 20 76 61 6c 75 65 20 74 |ange the| value t|
|00005530| 6f 20 61 20 70 6f 73 69 | 74 69 76 65 20 6e 75 6d |o a posi|tive num|
|00005540| 62 65 72 20 28 24 30 30 | 30 31 29 20 74 6f 20 61 |ber ($00|01) to a|
|00005550| 6c 6c 6f 63 61 74 65 20 | 6f 6e 6c 79 20 74 68 65 |llocate |only the|
|00005560| 20 73 65 63 6f 6e 64 61 | 72 79 20 73 6f 75 6e 64 | seconda|ry sound|
|00005570| 20 62 75 66 66 65 72 2e | 0d 57 61 72 6e 69 6e 67 | buffer.|.Warning|
|00005580| 3a 09 4d 61 63 73 42 75 | 67 20 6d 61 79 20 6e 6f |:.MacsBu|g may no|
|00005590| 74 20 77 6f 72 6b 20 70 | 72 6f 70 65 72 6c 79 20 |t work p|roperly |
|000055a0| 69 66 20 79 6f 75 20 61 | 6c 6c 6f 63 61 74 65 20 |if you a|llocate |
|000055b0| 61 64 64 69 74 69 6f 6e | 61 6c 20 70 61 67 65 73 |addition|al pages|
|000055c0| 20 66 6f 72 20 73 6f 75 | 6e 64 20 61 6e 64 20 76 | for sou|nd and v|
|000055d0| 69 64 65 6f 2e 0d 46 75 | 72 74 68 65 72 20 52 65 |ideo..Fu|rther Re|
|000055e0| 66 65 72 65 6e 63 65 3a | 0d a5 09 54 68 65 20 53 |ference:|...The S|
|000055f0| 65 67 6d 65 6e 74 20 4c | 6f 61 64 65 72 0d 44 56 |egment L|oader.DV|
|00005600| 20 34 20 2d 20 42 75 73 | 20 45 72 72 6f 72 20 48 | 4 - Bus| Error H|
|00005610| 61 6e 64 6c 65 72 73 0d | 44 65 76 69 63 65 73 09 |andlers.|Devices.|
|00005620| 0d 52 65 76 69 73 65 64 | 20 62 79 3a 09 43 6f 6c |.Revised| by:.Col|
|00005630| 6c 65 65 6e 20 4b 2e 20 | 44 65 6c 67 61 64 69 6c |leen K. |Delgadil|
|00005640| 6c 6f 09 4d 61 79 20 31 | 39 39 32 0d 57 72 69 74 |lo.May 1|992.Writ|
|00005650| 74 65 6e 20 62 79 3a 09 | 57 61 79 6e 65 20 4d 65 |ten by:.|Wayne Me|
|00005660| 72 65 74 73 6b 79 20 61 | 6e 64 20 52 69 63 68 20 |retsky a|nd Rich |
|00005670| 43 6f 6c 6c 79 65 72 09 | 46 65 62 72 75 61 72 79 |Collyer.|February|
|00005680| 20 31 39 39 31 0d 54 68 | 69 73 20 54 65 63 68 6e | 1991.Th|is Techn|
|00005690| 69 63 61 6c 20 4e 6f 74 | 65 20 64 69 73 63 75 73 |ical Not|e discus|
|000056a0| 73 65 73 20 62 75 73 20 | 65 72 72 6f 72 73 20 61 |ses bus |errors a|
|000056b0| 6e 64 20 68 6f 77 20 61 | 70 70 6c 69 63 61 74 69 |nd how a|pplicati|
|000056c0| 6f 6e 73 20 61 6e 64 20 | 64 72 69 76 65 72 73 20 |ons and |drivers |
|000056d0| 73 68 6f 75 6c 64 20 64 | 65 61 6c 20 77 69 74 68 |should d|eal with|
|000056e0| 20 74 68 65 6d 2e 0d 43 | 68 61 6e 67 65 73 20 73 | them..C|hanges s|
|000056f0| 69 6e 63 65 20 46 65 62 | 72 75 61 72 79 20 31 39 |ince Feb|ruary 19|
|00005700| 39 31 3a 20 44 69 73 63 | 75 73 73 69 6f 6e 20 6f |91: Disc|ussion o|
|00005710| 66 20 77 68 79 20 64 65 | 63 6c 61 72 61 74 69 6f |f why de|claratio|
|00005720| 6e 20 52 4f 4d 73 20 61 | 72 65 20 6e 65 63 65 73 |n ROMs a|re neces|
|00005730| 73 61 72 79 20 69 6e 20 | 4e 75 42 75 73 aa 20 64 |sary in |NuBus. d|
|00005740| 65 73 69 67 6e 2e 20 54 | 68 69 73 20 64 69 73 63 |esign. T|his disc|
|00005750| 75 73 73 69 6f 6e 20 69 | 73 20 69 6d 70 6f 72 74 |ussion i|s import|
|00005760| 61 6e 74 20 66 6f 72 20 | 74 68 6f 73 65 20 77 68 |ant for |those wh|
|00005770| 6f 20 61 72 65 20 63 6f | 6e 73 69 64 65 72 69 6e |o are co|nsiderin|
|00005780| 67 20 75 73 69 6e 67 20 | 61 20 77 6f 72 6b 61 72 |g using |a workar|
|00005790| 6f 75 6e 64 20 69 6e 73 | 74 65 61 64 20 6f 66 20 |ound ins|tead of |
|000057a0| 64 65 63 6c 61 72 61 74 | 69 6f 6e 20 52 4f 4d 73 |declarat|ion ROMs|
|000057b0| 2e 20 41 6c 73 6f 20 61 | 64 64 65 64 20 61 72 65 |. Also a|dded are|
|000057c0| 20 73 6f 6d 65 20 68 69 | 6e 74 73 20 74 68 61 74 | some hi|nts that|
|000057d0| 20 79 6f 75 20 73 68 6f | 75 6c 64 20 62 65 20 61 | you sho|uld be a|
|000057e0| 77 61 72 65 20 6f 66 20 | 69 66 20 79 6f 75 20 61 |ware of |if you a|
|000057f0| 72 65 20 70 6c 61 6e 6e | 69 6e 67 20 74 6f 20 77 |re plann|ing to w|
|00005800| 72 69 74 65 20 61 20 62 | 75 73 20 65 72 72 6f 72 |rite a b|us error|
|00005810| 20 68 61 6e 64 6c 65 72 | 20 66 6f 72 20 74 68 65 | handler| for the|
|00005820| 20 d5 30 34 30 2e 0d 49 | 6e 74 72 6f 64 75 63 74 | .040..I|ntroduct|
|00005830| 69 6f 6e 0d 42 75 73 20 | 65 72 72 6f 72 73 20 6f |ion.Bus |errors o|
|00005840| 63 63 75 72 20 77 69 74 | 68 69 6e 20 4d 61 63 69 |ccur wit|hin Maci|
|00005850| 6e 74 6f 73 68 20 73 79 | 73 74 65 6d 73 20 75 6e |ntosh sy|stems un|
|00005860| 64 65 72 20 61 20 76 61 | 72 69 65 74 79 20 6f 66 |der a va|riety of|
|00005870| 20 63 69 72 63 75 6d 73 | 74 61 6e 63 65 73 3a 20 | circums|tances: |
|00005880| 20 76 69 72 74 75 61 6c | 20 6d 65 6d 6f 72 79 20 | virtual| memory |
|00005890| 70 61 67 65 20 66 61 75 | 6c 74 73 2c 20 4e 75 42 |page fau|lts, NuB|
|000058a0| 75 73 20 74 72 61 6e 73 | 66 65 72 20 61 63 6b 6e |us trans|fer ackn|
|000058b0| 6f 77 6c 65 64 67 6d 65 | 6e 74 20 6f 74 68 65 72 |owledgme|nt other|
|000058c0| 20 74 68 61 6e 20 63 6f | 6d 70 6c 65 74 65 20 28 | than co|mplete (|
|000058d0| 65 72 72 6f 72 2c 20 74 | 69 6d 65 2d 6f 75 74 2c |error, t|ime-out,|
|000058e0| 20 74 72 79 2d 61 67 61 | 69 6e 2d 6c 61 74 65 72 | try-aga|in-later|
|000058f0| 29 2c 20 53 43 53 49 20 | 62 6c 69 6e 64 20 74 72 |), SCSI |blind tr|
|00005900| 61 6e 73 66 65 72 20 68 | 61 6e 64 73 68 61 6b 69 |ansfer h|andshaki|
|00005910| 6e 67 2c 20 61 6e 64 20 | 73 6f 20 6f 6e 2e 20 41 |ng, and |so on. A|
|00005920| 74 20 70 72 65 73 65 6e | 74 2c 20 41 70 70 6c 65 |t presen|t, Apple|
|00005930| 20 68 61 73 20 6e 6f 74 | 20 64 6f 63 75 6d 65 6e | has not| documen|
|00005940| 74 65 64 20 61 20 73 69 | 6e 67 6c 65 20 6d 6f 64 |ted a si|ngle mod|
|00005950| 65 6c 20 66 6f 72 20 68 | 61 6e 64 6c 69 6e 67 20 |el for h|andling |
|00005960| 62 75 73 20 65 72 72 6f | 72 73 2c 20 61 6e 64 20 |bus erro|rs, and |
|00005970| 61 73 20 61 20 72 65 73 | 75 6c 74 2c 20 73 79 73 |as a res|ult, sys|
|00005980| 74 65 6d 20 73 6f 66 74 | 77 61 72 65 2c 20 61 70 |tem soft|ware, ap|
|00005990| 70 6c 69 63 61 74 69 6f | 6e 73 2c 20 61 6e 64 20 |plicatio|ns, and |
|000059a0| 64 65 76 69 63 65 20 64 | 72 69 76 65 72 73 20 75 |device d|rivers u|
|000059b0| 73 65 20 76 61 72 69 6f | 75 73 20 74 65 63 68 6e |se vario|us techn|
|000059c0| 69 71 75 65 73 20 74 68 | 61 74 20 64 6f 20 6e 6f |iques th|at do no|
|000059d0| 74 20 61 6c 77 61 79 73 | 20 77 6f 72 6b 20 74 6f |t always| work to|
|000059e0| 67 65 74 68 65 72 20 61 | 6e 64 20 74 68 65 72 65 |gether a|nd there|
|000059f0| 66 6f 72 65 20 63 6f 6d | 70 72 6f 6d 69 73 65 20 |fore com|promise |
|00005a00| 73 79 73 74 65 6d 20 69 | 6e 74 65 67 72 69 74 79 |system i|ntegrity|
|00005a10| 2e 20 54 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |. The fo|llowing |
|00005a20| 69 73 20 74 68 65 20 73 | 65 63 6f 6e 64 20 72 65 |is the s|econd re|
|00005a30| 76 69 73 69 6f 6e 20 6f | 66 20 61 20 64 65 66 69 |vision o|f a defi|
|00005a40| 6e 69 74 69 76 65 20 73 | 74 61 74 65 6d 65 6e 74 |nitive s|tatement|
|00005a50| 20 6f 6e 20 62 75 73 20 | 65 72 72 6f 72 73 20 61 | on bus |errors a|
|00005a60| 6e 64 20 62 75 73 20 65 | 72 72 6f 72 20 68 61 6e |nd bus e|rror han|
|00005a70| 64 6c 69 6e 67 2e 0d 57 | 68 61 74 20 49 73 20 61 |dling..W|hat Is a|
|00005a80| 20 42 75 73 20 45 72 72 | 6f 72 3f 0d 41 20 62 75 | Bus Err|or?.A bu|
|00005a90| 73 20 65 72 72 6f 72 20 | 69 73 20 61 6e 20 65 76 |s error |is an ev|
|00005aa0| 65 6e 74 20 74 68 61 74 | 20 66 6f 72 63 65 73 20 |ent that| forces |
|00005ab0| 74 65 72 6d 69 6e 61 74 | 69 6f 6e 20 6f 66 20 61 |terminat|ion of a|
|00005ac0| 20 62 75 73 20 63 79 63 | 6c 65 2e 20 49 6e 20 73 | bus cyc|le. In s|
|00005ad0| 6f 6d 65 20 63 61 73 65 | 73 20 74 68 65 20 70 72 |ome case|s the pr|
|00005ae0| 6f 63 65 73 73 6f 72 20 | 74 61 6b 65 73 20 6e 6f |ocessor |takes no|
|00005af0| 20 70 72 6f 67 72 61 6d | 6d 65 72 2d 76 69 73 69 | program|mer-visi|
|00005b00| 62 6c 65 20 61 63 74 69 | 6f 6e 73 2c 20 61 73 20 |ble acti|ons, as |
|00005b10| 6d 61 79 20 68 61 70 70 | 65 6e 20 69 66 20 61 20 |may happ|en if a |
|00005b20| 70 72 65 66 65 74 63 68 | 69 6e 67 20 62 75 73 20 |prefetch|ing bus |
|00005b30| 63 79 63 6c 65 20 72 65 | 73 75 6c 74 73 20 69 6e |cycle re|sults in|
|00005b40| 20 61 20 62 75 73 20 65 | 72 72 6f 72 20 62 75 74 | a bus e|rror but|
|00005b50| 20 74 68 65 20 70 72 65 | 66 65 74 63 68 65 64 20 | the pre|fetched |
|00005b60| 64 61 74 61 20 69 73 20 | 6e 6f 74 20 65 78 65 63 |data is |not exec|
|00005b70| 75 74 65 64 2c 20 6f 72 | 20 61 73 20 6d 61 79 20 |uted, or| as may |
|00005b80| 68 61 70 70 65 6e 20 64 | 75 72 69 6e 67 20 61 20 |happen d|uring a |
|00005b90| 63 61 63 68 65 20 66 69 | 6c 6c 20 62 75 72 73 74 |cache fi|ll burst|
|00005ba0| 2e 20 54 79 70 69 63 61 | 6c 6c 79 2c 20 74 68 65 |. Typica|lly, the|
|00005bb0| 20 74 65 72 6d 69 6e 61 | 74 69 6f 6e 20 6f 66 20 | termina|tion of |
|00005bc0| 61 20 62 75 73 20 63 79 | 63 6c 65 20 62 79 20 61 |a bus cy|cle by a|
|00005bd0| 20 62 75 73 20 65 72 72 | 6f 72 20 64 6f 65 73 20 | bus err|or does |
|00005be0| 72 65 73 75 6c 74 20 69 | 6e 20 74 68 65 20 70 72 |result i|n the pr|
|00005bf0| 6f 63 65 73 73 6f 72 20 | 74 61 6b 69 6e 67 20 70 |ocessor |taking p|
|00005c00| 72 6f 67 72 61 6d 6d 65 | 72 2d 76 69 73 69 62 6c |rogramme|r-visibl|
|00005c10| 65 20 61 63 74 69 6f 6e | 73 2e 20 54 68 65 73 65 |e action|s. These|
|00005c20| 20 61 63 74 69 6f 6e 73 | 2c 20 63 6f 6c 6c 65 63 | actions|, collec|
|00005c30| 74 69 76 65 6c 79 20 63 | 61 6c 6c 65 64 20 42 75 |tively c|alled Bu|
|00005c40| 73 20 45 72 72 6f 72 20 | 45 78 63 65 70 74 69 6f |s Error |Exceptio|
|00005c50| 6e 20 50 72 6f 63 65 73 | 73 69 6e 67 2c 20 69 6e |n Proces|sing, in|
|00005c60| 63 6c 75 64 65 20 74 65 | 72 6d 69 6e 61 74 69 6f |clude te|rminatio|
|00005c70| 6e 20 6f 66 20 74 68 65 | 20 69 6e 73 74 72 75 63 |n of the| instruc|
|00005c80| 74 69 6f 6e 20 74 68 61 | 74 20 63 61 75 73 65 64 |tion tha|t caused|
|00005c90| 20 74 68 65 20 62 75 73 | 20 65 72 72 6f 72 2c 20 | the bus| error, |
|00005ca0| 63 72 65 61 74 69 6f 6e | 20 6f 66 20 61 6e 20 65 |creation| of an e|
|00005cb0| 78 63 65 70 74 69 6f 6e | 20 73 74 61 63 6b 20 66 |xception| stack f|
|00005cc0| 72 61 6d 65 20 6f 6e 20 | 74 68 65 20 61 70 70 72 |rame on |the appr|
|00005cd0| 6f 70 72 69 61 74 65 20 | 73 79 73 74 65 6d 20 73 |opriate |system s|
|00005ce0| 74 61 63 6b 2c 20 61 6e | 64 20 74 72 61 6e 73 66 |tack, an|d transf|
|00005cf0| 65 72 20 6f 66 20 63 6f | 6e 74 72 6f 6c 20 74 6f |er of co|ntrol to|
|00005d00| 20 74 68 65 20 62 75 73 | 20 65 72 72 6f 72 20 68 | the bus| error h|
|00005d10| 61 6e 64 6c 65 72 20 64 | 65 73 69 67 6e 61 74 65 |andler d|esignate|
|00005d20| 64 20 62 79 20 74 68 65 | 20 63 75 72 72 65 6e 74 |d by the| current|
|00005d30| 20 62 75 73 20 65 72 72 | 6f 72 20 76 65 63 74 6f | bus err|or vecto|
|00005d40| 72 2e 20 42 75 73 20 45 | 72 72 6f 72 20 45 78 63 |r. Bus E|rror Exc|
|00005d50| 65 70 74 69 6f 6e 20 50 | 72 6f 63 65 73 73 69 6e |eption P|rocessin|
|00005d60| 67 20 64 6f 65 73 20 6e | 6f 74 20 69 6e 63 6c 75 |g does n|ot inclu|
|00005d70| 64 65 20 74 68 65 20 65 | 78 65 63 75 74 69 6f 6e |de the e|xecution|
|00005d80| 20 6f 66 20 74 68 65 20 | 62 75 73 20 65 72 72 6f | of the |bus erro|
|00005d90| 72 20 68 61 6e 64 6c 65 | 72 2e 0d 54 68 65 20 63 |r handle|r..The c|
|00005da0| 61 75 73 65 20 6f 66 20 | 62 75 73 20 65 72 72 6f |ause of |bus erro|
|00005db0| 72 73 20 69 73 20 64 69 | 66 66 65 72 65 6e 74 20 |rs is di|fferent |
|00005dc0| 6f 6e 20 64 69 66 66 65 | 72 65 6e 74 20 6d 65 6d |on diffe|rent mem|
|00005dd0| 62 65 72 73 20 6f 66 20 | 74 68 65 20 4d 36 38 30 |bers of |the M680|
|00005de0| 30 30 20 66 61 6d 69 6c | 79 2e 20 4f 6e 20 61 6c |00 famil|y. On al|
|00005df0| 6c 20 6d 65 6d 62 65 72 | 73 20 75 70 20 74 6f 20 |l member|s up to |
|00005e00| 61 6e 64 20 69 6e 63 6c | 75 64 69 6e 67 20 74 68 |and incl|uding th|
|00005e10| 65 20 4d 43 36 38 30 32 | 30 2c 20 74 68 65 20 6f |e MC6802|0, the o|
|00005e20| 6e 6c 79 20 63 61 75 73 | 65 20 6f 66 20 62 75 73 |nly caus|e of bus|
|00005e30| 20 65 72 72 6f 72 73 20 | 69 73 20 61 73 73 65 72 | errors |is asser|
|00005e40| 74 69 6f 6e 20 6f 66 20 | 74 68 65 20 2f 42 45 52 |tion of |the /BER|
|00005e50| 52 20 73 69 67 6e 61 6c | 20 28 6e 6f 74 65 20 74 |R signal| (note t|
|00005e60| 68 61 74 20 74 68 65 20 | 61 73 73 65 72 74 69 6f |hat the |assertio|
|00005e70| 6e 20 6f 66 20 2f 42 45 | 52 52 20 61 6e 64 20 2f |n of /BE|RR and /|
|00005e80| 48 41 4c 54 20 69 6e 64 | 69 63 61 74 65 73 20 61 |HALT ind|icates a|
|00005e90| 20 62 75 73 20 72 65 74 | 72 79 20 6f 70 65 72 61 | bus ret|ry opera|
|00005ea0| 74 69 6f 6e 2c 20 6e 6f | 74 20 61 20 62 75 73 20 |tion, no|t a bus |
|00005eb0| 65 72 72 6f 72 29 2e 20 | 4f 6e 20 74 68 65 20 4d |error). |On the M|
|00005ec0| 43 36 38 30 33 30 2c 20 | 62 75 73 20 65 72 72 6f |C68030, |bus erro|
|00005ed0| 72 73 20 63 61 6e 20 62 | 65 20 63 61 75 73 65 64 |rs can b|e caused|
|00005ee0| 20 62 79 20 65 69 74 68 | 65 72 20 74 68 65 20 61 | by eith|er the a|
|00005ef0| 73 73 65 72 74 69 6f 6e | 20 6f 66 20 74 68 65 20 |ssertion| of the |
|00005f00| 2f 42 45 52 52 20 73 69 | 67 6e 61 6c 20 6f 72 20 |/BERR si|gnal or |
|00005f10| 62 79 20 74 68 65 20 69 | 6e 74 65 72 6e 61 6c 20 |by the i|nternal |
|00005f20| 4d 4d 55 20 64 75 72 69 | 6e 67 20 61 64 64 72 65 |MMU duri|ng addre|
|00005f30| 73 73 20 74 72 61 6e 73 | 6c 61 74 69 6f 6e 2e 20 |ss trans|lation. |
|00005f40| 54 68 65 20 4d 43 36 38 | 30 34 30 20 69 73 20 73 |The MC68|040 is s|
|00005f50| 69 6d 69 6c 61 72 20 74 | 6f 20 74 68 65 20 4d 43 |imilar t|o the MC|
|00005f60| 36 38 30 33 30 2c 20 65 | 78 63 65 70 74 20 74 68 |68030, e|xcept th|
|00005f70| 61 74 20 74 68 65 20 74 | 65 72 6d 20 62 75 73 20 |at the t|erm bus |
|00005f80| 65 72 72 6f 72 20 68 61 | 73 20 62 65 65 6e 20 72 |error ha|s been r|
|00005f90| 65 70 6c 61 63 65 64 20 | 77 69 74 68 20 74 68 65 |eplaced |with the|
|00005fa0| 20 74 65 72 6d 20 61 63 | 63 65 73 73 20 65 72 72 | term ac|cess err|
|00005fb0| 6f 72 2c 20 61 6e 64 20 | 74 68 65 20 73 69 67 6e |or, and |the sign|
|00005fc0| 61 6c 20 2f 42 45 52 52 | 20 68 61 73 20 62 65 65 |al /BERR| has bee|
|00005fd0| 6e 20 72 65 70 6c 61 63 | 65 64 20 77 69 74 68 20 |n replac|ed with |
|00005fe0| 74 68 65 20 73 69 67 6e | 61 6c 20 2f 54 45 41 20 |the sign|al /TEA |
|00005ff0| 28 74 68 69 73 20 4e 6f | 74 65 20 75 73 65 73 20 |(this No|te uses |
|00006000| 70 72 65 2d 4d 43 36 38 | 30 34 30 20 74 65 72 6d |pre-MC68|040 term|
|00006010| 69 6e 6f 6c 6f 67 79 29 | 2e 0d 57 68 61 74 20 49 |inology)|..What I|
|00006020| 73 20 61 20 42 75 73 20 | 45 72 72 6f 72 20 48 61 |s a Bus |Error Ha|
|00006030| 6e 64 6c 65 72 3f 0d 41 | 20 62 75 73 20 65 72 72 |ndler?.A| bus err|
|00006040| 6f 72 20 68 61 6e 64 6c | 65 72 20 69 73 20 74 68 |or handl|er is th|
|00006050| 65 20 65 78 63 65 70 74 | 69 6f 6e 20 68 61 6e 64 |e except|ion hand|
|00006060| 6c 65 72 20 66 6f 72 20 | 74 68 65 20 62 75 73 20 |ler for |the bus |
|00006070| 65 72 72 6f 72 20 65 78 | 63 65 70 74 69 6f 6e 20 |error ex|ception |
|00006080| 61 6e 64 20 69 73 20 64 | 65 73 69 67 6e 61 74 65 |and is d|esignate|
|00006090| 64 20 62 79 20 6f 66 66 | 73 65 74 20 24 30 38 20 |d by off|set $08 |
|000060a0| 69 6e 20 74 68 65 20 45 | 78 63 65 70 74 69 6f 6e |in the E|xception|
|000060b0| 20 56 65 63 74 6f 72 20 | 54 61 62 6c 65 2e 20 54 | Vector |Table. T|
|000060c0| 68 65 20 62 75 73 20 65 | 72 72 6f 72 20 68 61 6e |he bus e|rror han|
|000060d0| 64 6c 65 72 20 69 73 20 | 72 65 73 70 6f 6e 73 69 |dler is |responsi|
|000060e0| 62 6c 65 20 66 6f 72 20 | 74 68 65 20 72 65 63 6f |ble for |the reco|
|000060f0| 76 65 72 79 20 66 72 6f | 6d 20 74 68 65 20 63 6f |very fro|m the co|
|00006100| 6e 64 69 74 69 6f 6e 73 | 20 74 68 61 74 20 6c 65 |nditions| that le|
|00006110| 64 20 74 6f 20 74 68 65 | 20 62 75 73 20 65 72 72 |d to the| bus err|
|00006120| 6f 72 2e 20 44 65 70 65 | 6e 64 69 6e 67 20 6f 6e |or. Depe|nding on|
|00006130| 20 74 68 65 20 63 61 75 | 73 65 20 6f 66 20 74 68 | the cau|se of th|
|00006140| 65 20 62 75 73 20 65 72 | 72 6f 72 2c 20 72 65 63 |e bus er|ror, rec|
|00006150| 6f 76 65 72 79 20 6d 61 | 79 20 62 65 20 65 69 74 |overy ma|y be eit|
|00006160| 68 65 72 20 73 69 6d 70 | 6c 65 20 6f 72 20 65 78 |her simp|le or ex|
|00006170| 74 72 65 6d 65 6c 79 20 | 63 6f 6d 70 6c 65 78 2e |tremely |complex.|
|00006180| 20 49 6e 20 74 68 65 20 | 63 61 73 65 20 6f 66 20 | In the |case of |
|00006190| 61 20 70 61 67 65 20 66 | 61 75 6c 74 2c 20 74 68 |a page f|ault, th|
|000061a0| 65 20 72 65 63 6f 76 65 | 72 79 20 70 72 6f 63 65 |e recove|ry proce|
|000061b0| 73 73 20 65 6e 74 61 69 | 6c 73 20 6c 6f 61 64 69 |ss entai|ls loadi|
|000061c0| 6e 67 20 74 68 65 20 64 | 65 73 69 72 65 64 20 70 |ng the d|esired p|
|000061d0| 61 67 65 20 69 6e 74 6f | 20 70 68 79 73 69 63 61 |age into| physica|
|000061e0| 6c 20 6d 65 6d 6f 72 79 | 20 61 6e 64 20 75 70 64 |l memory| and upd|
|000061f0| 61 74 69 6e 67 20 74 68 | 65 20 4d 4d 55 20 50 61 |ating th|e MMU Pa|
|00006200| 67 65 20 54 61 62 6c 65 | 73 2e 20 49 6e 20 74 68 |ge Table|s. In th|
|00006210| 65 20 63 61 73 65 20 6f | 66 20 61 20 4e 75 42 75 |e case o|f a NuBu|
|00006220| 73 20 74 72 79 2d 61 67 | 61 69 6e 2d 6c 61 74 65 |s try-ag|ain-late|
|00006230| 72 20 61 63 6b 6e 6f 77 | 6c 65 64 67 6d 65 6e 74 |r acknow|ledgment|
|00006240| 2c 20 74 68 65 20 72 65 | 63 6f 76 65 72 79 20 70 |, the re|covery p|
|00006250| 72 6f 63 65 73 73 20 69 | 73 20 74 6f 20 73 69 6d |rocess i|s to sim|
|00006260| 70 6c 79 20 72 65 74 72 | 79 20 74 68 65 20 62 75 |ply retr|y the bu|
|00006270| 73 20 63 79 63 6c 65 20 | 74 68 61 74 20 63 61 75 |s cycle |that cau|
|00006280| 73 65 64 20 74 68 65 20 | 62 75 73 20 65 72 72 6f |sed the |bus erro|
|00006290| 72 2e 0d 46 72 6f 6d 20 | 74 68 65 20 70 72 6f 63 |r..From |the proc|
|000062a0| 65 73 73 6f 72 d5 73 20 | 70 65 72 73 70 65 63 74 |essor.s |perspect|
|000062b0| 69 76 65 2c 20 74 68 65 | 72 65 20 69 73 2c 20 61 |ive, the|re is, a|
|000062c0| 74 20 61 6e 79 20 6f 6e | 65 20 74 69 6d 65 2c 20 |t any on|e time, |
|000062d0| 6f 6e 6c 79 20 61 20 73 | 69 6e 67 6c 65 20 68 61 |only a s|ingle ha|
|000062e0| 6e 64 6c 65 72 20 66 6f | 72 20 61 6c 6c 20 62 75 |ndler fo|r all bu|
|000062f0| 73 20 65 72 72 6f 72 20 | 65 78 63 65 70 74 69 6f |s error |exceptio|
|00006300| 6e 73 2e 20 54 68 61 74 | 20 68 61 6e 64 6c 65 72 |ns. That| handler|
|00006310| 20 69 73 20 74 68 65 20 | 6f 6e 65 20 64 65 73 69 | is the |one desi|
|00006320| 67 6e 61 74 65 64 20 62 | 79 20 6f 66 66 73 65 74 |gnated b|y offset|
|00006330| 20 24 30 38 20 69 6e 20 | 74 68 65 20 45 78 63 65 | $08 in |the Exce|
|00006340| 70 74 69 6f 6e 20 56 65 | 63 74 6f 72 20 54 61 62 |ption Ve|ctor Tab|
|00006350| 6c 65 2e 0d 46 72 6f 6d | 20 74 68 65 20 73 79 73 |le..From| the sys|
|00006360| 74 65 6d 20 70 72 6f 67 | 72 61 6d 6d 65 72 d5 73 |tem prog|rammer.s|
|00006370| 20 70 65 72 73 70 65 63 | 74 69 76 65 2c 20 74 68 | perspec|tive, th|
|00006380| 65 72 65 20 61 72 65 20 | 6d 61 6e 79 20 70 69 65 |ere are |many pie|
|00006390| 63 65 73 20 6f 66 20 73 | 6f 66 74 77 61 72 65 20 |ces of s|oftware |
|000063a0| 74 68 61 74 20 77 6f 72 | 6b 20 69 6e 20 75 6e 69 |that wor|k in uni|
|000063b0| 73 6f 6e 20 61 6e 64 20 | 66 6f 72 6d 20 74 68 65 |son and |form the|
|000063c0| 20 62 75 73 20 65 72 72 | 6f 72 20 68 61 6e 64 6c | bus err|or handl|
|000063d0| 65 72 2e 20 45 61 63 68 | 20 6f 66 20 74 68 65 73 |er. Each| of thes|
|000063e0| 65 20 69 6e 64 69 76 69 | 64 75 61 6c 20 70 69 65 |e indivi|dual pie|
|000063f0| 63 65 73 20 65 78 69 73 | 74 73 20 69 6e 20 61 6e |ces exis|ts in an|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
